用途
skill-explorer 是用户面对庞大技能库时的“入口技能”，专门回答“我有哪些技能 / 哪个技能适合这件事”。当技能名称彼此相似、描述互相重叠，或者用户容易误用编排器（orchestrator）作为入口时，它负责澄清、回忆和路由，但只给出技能名称，不实际调用。
与其他相近技能的区别
- skill-explorer（本技能）：用于发现、回忆、解释和路由；指出正确的技能后即停止，由用户自行触发。
- madness：希望把路由决策直接执行时使用，它会挑选入口点并启动（对高成本操作会先确认）。
- skill-catalog：需要权威的已安装技能清单与数量统计时使用，而非回忆或路由。
主要能力（四种模式）
- 回忆（Recall）：用户忘记技能名称时，返回技能名称（代码格式）及一句话说明；无法锁定单一技能时列出 2–3 个候选。
- 清单（Catalog）：用户想查看全部技能时，按类别分组，每行一个技能，附 12 词以内的说明；如涉及插件技能，会与仓库技能分开标注。
- 解释（Explain）：说明技能的目的、触发条件、产出物、关联技能，以及由谁派生；信息来自 SKILL.md 前元数据。
- 路由（Route）：针对用户目标推荐一个技能并说明理由；仅在请求确实模棱两可时给出备选。
使用方式与数据来源
按优先级读取：首先使用当前会话已加载的技能名称与描述（多数问题足够）；需要更深细节（composes_with、spawned_by、owns）或描述无法区分时，读取 SKILL.md 的前元数据（如前 30 行）；只有需要深入解释或排查触发问题时才读取正文。在 Skill Madness 仓库中，技能位于 skills/orchestrator/SKILL.md 以及 skills/{contracts,git,loops,meta,roles,workflows}/<skill-name>/SKILL.md；插件技能来自 ~/.claude/plugins/，在会话上下文中可见但不在仓库目录树中。输出保持简短，先给技能名再解释。
路由经验规则
- “用多个智能体构建 X / 群体构建” → orchestrator。
- “我只想写/改一处东西” → 直接推荐角色技能（如 backend-agent、frontend-agent），而非 orchestrator。
- “设计/重建/重做 UI” → 先用 ui-brief 产出简报，再用 frontend-design 或 frontend-agent 构建。
- “根据研究/PRD 制定计划” → plan-builder，之后可选 orchestrator 执行。
- “审计/评审我的技能” → skill-review（--scope=all 批量，--scope=<name> 深入）。
- “创建新技能” → skill-writer。
- “全局同步/链接技能” → sync-skills。
- “提交/分支/PR” → git-commit、git-pr 等。
- 插件技能使用完整命名空间（如 superpowers:、claude-mem:）以便用户调用。
适用场景
当用户记不清技能名称、想了解技能库全貌、需要理解某技能何时触发与产出什么、或需要为具体任务挑选入口时使用。若用户已经明确指定要运行的技能、正在任务中途提出应由当前技能处理的领域问题、想创建新技能（skill-writer）或审计技能（skill-review），则不应调用本技能。
限制与反模式
- 核心原则是“只命名，不调用”：不替用户自动调用推荐技能；唯一例外是意图明确且用户在同一条消息中明确说“开始吧/用它”。
- 不应为了回答“我有哪些技能”而读取每个 SKILL.md，描述已在会话上下文中。
- 不应为单技能任务推荐 orchestrator，它只负责多智能体协调。
- 一个技能明显合适时只给一个，不要罗列 5 个候选。
- 不编造技能名；找不到时说明“没有技能覆盖此需求，最接近的是 X”。
- 更完整的请求到技能映射见 references/routing-table.md，技能发现与路由问题的症状分类见 references/troubleshooting.md。