技能路由器
- 作者仓库星标 253
- 作者仓库 claudia
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @kbanc85 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Skill Router
Two jobs: help the user find the skill they need, and help me (Claudia) pick the right skill when their request straddles two or more.
## Why this exists
The shipped catalog has ~42 user-facing skills. Two common failure modes:
1. **Users don't know what's available.** They type "morning brief" because they've seen `/morning-brief` somewhere, but they don't know `/inbox-check`, `/pipeline-review`, or `/what-am-i-missing` exist. Friction.
2. **Ambiguous requests fire the wrong skill.** "Summarize this" could be `summarize-doc`, `capture-meeting`, or `file-document` depending on what comes next. I sometimes pick the wrong one, the user gets the wrong output, both of us waste a turn.
This skill addresses both.
## Surface 1: Discovery
When the user says "what can you do?", "/skills", "show me your skills", "list commands", "what skills do you have":
Respond with a categorized list. Keep it scannable:
```
**📋 Daily flow**
- /morning-brief start-of-day digest
- /inbox-check email triage across configured accounts
- /meeting-prep [person] one-page brief before a call
- /capture-meeting process meeting notes after a call
- /follow-up-draft draft a post-meeting thank-you
**📊 Reviews & reflection**
- /weekly-review end-of-week reflection
- /growth-check monthly or quarterly self-development
- /what-am-i-missing overdue, cooling, blind-spot sweep
**💼 Pipeline & business**
- /pipeline-review active opportunities + stalled items
- /client-health health check across active clients
- /financial-snapshot revenue, expenses, cash position
**📚 Knowledge & memory**
- /memory-audit what I know about an entity
- /memory-health memory system stats
- /wiki write or update a synthesized wiki page
- /map-connections extract relationships across files
- /deep-context full-context analysis for important decisions
**✍️ Drafting**
- /draft-reply general email response
- /summarize-doc executive summary of a document
- /auto-research iterate on a draft until it scores well
**🏗 Setup**
- /new-person create a relationship file
- /new-workspace new project or client workspace
- /file-document save a document with entity links
- /ingest-sources batch-process multiple sources
- /diagnose troubleshoot memory connectivity
```
Don't list every skill. List the ones a user is most likely to invoke directly. Internal skills (proactive ones like `commitment-detector`, `pattern-recognizer`, `risk-surfacer`) fire on their own and don't need to be in the discovery list.
If the user asks `/skills <topic>` or "what skills are about <topic>", filter the list to skills whose names or descriptions match, and explain the cluster. Example for `/skills meeting`:
```
Three skills for meetings, in order of when they fire:
- /meeting-prep [person] → before the call (one-page brief)
- /capture-meeting → during or after (process notes)
- /follow-up-draft → after (post-meeting email)
```
## Surface 2: Disambiguation
When the user's request matches 2+ skills, name the candidates briefly and proceed with the canonical one. Don't make the user choose; choose for them, and tell them what you chose.
### How to detect ambiguity
A request is ambiguous when:
- The trigger phrase appears in 2+ skill descriptions
- The request is in one of the known overlap clusters (see references/overlap-clusters.md)
- The artifact type is ambiguous (a "transcript" could be a meeting transcript → `capture-meeting`, or a research interview → `ingest-sources`, or just a generic document → `file-document`)
### How to disambiguate
Pattern: "Sounds like X or Y. I'll do X. Say so if you wanted Y."
Examples:
> User: "Help me draft a follow-up"
> Claudia: "Sounds like either `draft-reply` (general response) or `follow-up-draft` (post-meeting thank-you with meeting context). Was this from a call we had? If yes, `follow-up-draft`; if not, `draft-reply`. Defaulting to `follow-up-draft` since you said 'follow-up'."
> User: "Summarize this meeting"
> Claudia: "I'll use `capture-meeting` (extracts decisions, commitments, blockers from meeting notes). If you wanted a one-shot prose summary without filing as memories, say `summarize-doc` instead."
> User: "What's going on?"
> Claudia: "Default for that phrasing is `morning-brief`. Was that what you wanted, or did you mean `/what-am-i-missing` (risks and gaps), `pipeline-review` (deal status), or just an answer about a specific entity? Going with `morning-brief`."
The pattern: pick the canonical, name the alternative, run.
### When NOT to disambiguate
- The request is unambiguous. Don't manufacture options.
- The user has been specific. "Draft a reply to this email" is `draft-reply`, no need to mention `follow-up-draft`.
- The disambiguation explanation would be longer than the actual response. For short tasks, just do the canonical thing and let the user redirect.
## Overlap clusters (the canonical map)
See `references/overlap-clusters.md` for the full map. The clusters I check most often:
| Cluster | Canonical | Adjacent |
|---------|-----------|----------|
| Outbound messages | `draft-reply` (general), `follow-up-draft` (post-meeting) | `inbox-check` (triage before drafting) |
| Memory views | `memory-audit` (content), `memory-health` (system), `diagnose` (connectivity) | |
| Visualization | `brain` (3D web), `brain-monitor` (terminal) | |
| Reflective cadences | `morning-brief` (daily) → `weekly-review` (weekly) → `growth-check` (monthly+) → `meditate` (session) | |
| Meeting lifecycle | `meeting-prep` (before) → `capture-meeting` (during/after) → `follow-up-draft` (after, outbound) | |
| Risks and gaps | `what-am-i-missing` (user-invoked) | `risk-surfacer` (proactive auto-fire) |
| People and relationships | `relationship-tracker` (ongoing), `new-person` (create), `map-connections` (extract graph) | `connector-discovery` (external services, NOT people) |
| Patterns/judgment/capability | `pattern-recognizer` (notice) → `judgment-awareness` (apply rules) → `capability-suggester` (propose commands) | `hire-agent` (propose new subagents) |
| Inbound processing | `ingest-sources` (multi-doc), `file-document` (single doc), `capture-meeting` (meeting only), `summarize-doc` (no filing) | |
## Skill index integration
The `skill-index.json` file at `template-v2/.claude/skills/skill-index.json` is the structured catalog this skill reads. Each entry has:
- `name`: slug
- `description`: one-line description
- `category`: which discovery category the skill falls in (daily, reviews, pipeline, knowledge, drafting, setup, internal)
- `canonical_for`: list of request patterns where this skill is the canonical choice (used by disambiguation)
- `see_also`: list of adjacent skills (set in PR3's see-also work)
When skill-router is invoked, it loads skill-index.json and uses these fields. The discovery list above is generated from `category`. Disambiguation uses `canonical_for` and `see_also`.
## See also
- `agent-dispatcher` for routing tasks to subagents (different concept: this is about which Claudia *skill* fires; agent-dispatcher is about which *subagent* gets a task)
- `capability-suggester` for proposing *new* skills when patterns emerge that current skills don't cover
## Open questions for future versions
- **Telemetry.** Logging which skills fire on which inputs would let me learn over time which routings are wrong and propose corrections via `capability-suggester`. Not in this version.
- **Per-user customization.** Some users invoke `weekly-review` weekly; others never use it. The discovery list should adapt to the user's actual usage over time. Not in this version.
- **Skill search by example.** "Show me a skill that does X for Y" → semantic search over skill descriptions. Not in this version; today the user filters by keyword via `/skills <keyword>`.
章节与文件索引
按说明文件中的顺序排列。
为什么存在这个
表面 1:发现
表层 2:消歧
如何检测歧义
如何消除歧义
文件/命令 -> /morning-brief · /inbox-check · /pipeline-review · /what-am-i-missing · summarize-doc · capture-meeting · file-document · commitment-detector
内容校验值 -> 21f04f497ffe
当前原文的自动摘译,尚未人工审校。
为什么存在这个
附带的目录包含约 42 项面向用户的技能。两种常见的故障模式: 用户不知道什么是可用的。他们输入“早间简报”是因为他们在某处看到了
/morning-brief,但他们不知道/inbox-check、/pipeline-review或/what-am-i-missing存在。摩擦。不明确的请求会激发错误的技能。 “总结一下”可以是summarize-doc、capture-meeting或file-document,具体取决于接下来的内容。有时我会选错一个,用户会得到错误的输出,我们都浪费了一个回合。表面 1:发现
当用户说“你能做什么?”、“/技能”、“告诉我你的技能”、“列出命令”、“你有什么技能”时:用分类列表进行响应。保持可浏览性:不要列出所有技能。列出用户最有可能直接调用的那些。内部技能(主动技能,如
commitment-detector、pattern-recognizer、risk-surfacer)会自行触发,不需要出现在发现列表中。表层 2:消歧
当用户的请求与 2 个以上技能匹配时,请简要列出候选者的名称,然后继续使用规范的技能。不要让用户选择;为他们选择,并告诉他们你的选择。
如何检测歧义
在以下情况下,请求不明确: 触发短语出现在 2 个以上的技能描述中 请求位于已知重叠集群之一中(请参阅引用/overlap-clusters.md) 工件类型不明确(“记录”可以是会议记录 →
capture-meeting,或研究访谈 →ingest-sources,或只是通用文档 →file-document)如何消除歧义
模式:“听起来像 X 或 Y。我会做 X。如果你想要 Y,就这么说。”示例:用户:“帮我起草一份后续行动” Claudia:“听起来像是
draft-reply(一般性回应)或follow-up-draft(会后感谢会议背景)。这是我们之间的通话吗?如果是,则follow-up-draft;如果没有,则draft-reply。默认为follow-up-draft,因为您说过‘后续行动’。”用户:“总结一下这次会议”