From 52922a6ce43ee526058eef8204a71252b59de930 Mon Sep 17 00:00:00 2001 From: vitya Date: Thu, 21 May 2026 23:31:51 +0300 Subject: [PATCH] using-interns v0.2.2: proactive offer trigger MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Скил активируется при распознавании task-shape (3+ файлов / >400 строк / transcript distill), не только на явной фразе. Без этого описанный workflow «Identify candidate → ask» не запускался у агента до явной просьбы пользователя. --- skills/using-interns/SKILL.md | 26 ++++++++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/skills/using-interns/SKILL.md b/skills/using-interns/SKILL.md index 2f7ee8a..23c0dcc 100644 --- a/skills/using-interns/SKILL.md +++ b/skills/using-interns/SKILL.md @@ -1,7 +1,7 @@ --- name: using-interns -version: 0.2.1 -description: Use when delegating predictable bulk reads or summarization to cheap intern LLMs via the local `interns` MCP server (`mcp__interns__bulk_text_read`, `mcp__interns__transcript_distill`, etc.) so Claude saves Anthropic quota. Activated by `delegate to interns when allowed` in CLAUDE.md or explicit phrases like "use interns", "delegate to an intern", "разреши интернов", "allow interns". Per-session permission grant mirrors `project-discipline` Rule 4: ask-mode default, conversational grant / revoke, always-ask paths for `.env` / secrets / keys / SSH / credentials even with active grant, transitive rule (Claude can't bypass by reading the file itself and forwarding content), session-end reset. Skip for architecture, debugging, auth / payments, final commit messages, or final user-facing text. +version: 0.2.2 +description: Use when delegating predictable bulk reads or summarization to cheap intern LLMs via the local `interns` MCP server (`mcp__interns__bulk_text_read`, `mcp__interns__transcript_distill`, etc.) so Claude saves Anthropic quota. Activated by `delegate to interns when allowed` in CLAUDE.md or explicit phrases like "use interns", "delegate to an intern", "разреши интернов", "allow interns". **Also activates proactively when Claude is about to read 3+ files for context, read a single file >400 lines for non-edit purposes, or distill a long transcript — surface the offer "знаю, что есть интерны — заюзать?" before proceeding, even without an explicit user phrase.** Per-session permission grant mirrors `project-discipline` Rule 4: ask-mode default, conversational grant / revoke, always-ask paths for `.env` / secrets / keys / SSH / credentials even with active grant, transitive rule (Claude can't bypass by reading the file itself and forwarding content), session-end reset. Skip for architecture, debugging, auth / payments, final commit messages, or final user-facing text. --- # Using the `interns` MCP server @@ -32,6 +32,28 @@ This skill assumes `mcp__interns__*` tools are available. If they aren't (tools - **Transcript / session distillation** before writing a wiki log entry, summary, or post-mortem. - Any future intern documented in `.common/config/interns/config.yaml` (PDF extraction via Marker, repo packaging via Repomix, JS-rendered web fetches via Firecrawl, etc.) — same trigger / grant rules apply. +### Offer proactively — don't wait to be asked + +When any of the conditions above match a task you're about to perform, **the offer is your first action**, not a reaction to the user mentioning interns. The user shouldn't have to remember the catalog exists — that's your job. + +- **Ask-mode (default)** — surface a short offer in the user's language before proceeding: + + > Знаю, что есть интерны — могу заюзать `` для ``? + + English equivalent: + + > Interns can handle this — want me to delegate `` to ``? + + Keep it short. Don't pre-quote cost / model / tool name in the offer — those are in the catalog, the user can ask if curious. Verbose ask = friction = user defaults to "just do it yourself" even when delegation was the better move. + +- **Grant active** — skip the offer entirely. Delegate with a one-line FYI: + + > Делегирую `` для `` (` файлов` / ` строк`). + +- **Recognition heuristics for "I'm about to do an intern-shaped task":** mid-task, before issuing N `Read`s in a batch, ask yourself: would this become 3+ Read calls? Is the file I'm about to open >400 lines and I won't edit it? Am I reading a transcript to summarize, not to navigate? Any yes → offer. + +This is the change that actually delivers the savings — the catalog is useless if Claude only remembers it when prompted. + ## When NOT to use - **Architecture / design decisions.** Cheap models miss subtle trade-offs.