using-interns v0.2.2: proactive offer trigger

Скил активируется при распознавании task-shape (3+ файлов /
>400 строк / transcript distill), не только на явной фразе.
Без этого описанный workflow «Identify candidate → ask» не
запускался у агента до явной просьбы пользователя.
This commit is contained in:
2026-05-21 23:31:51 +03:00
parent 93a37f9aa5
commit 52922a6ce4

View File

@@ -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:
> Знаю, что есть интерны — могу заюзать `<intern>` для `<task>`?
English equivalent:
> Interns can handle this — want me to delegate `<task>` to `<intern>`?
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:
> Делегирую `<intern>` для `<task>` (`<N> файлов` / `<N> строк`).
- **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.