using-skills 是一个面向智能体(如 Claude Code)的技能路由索引,作用是在实际动手完成任务之前,先判断“这个任务应该由哪个技能负责”。资料明确要求:在对以下任何工作手动处理之前调用本技能,包括 .pdf 读取或填写、测试计划、架构改进、第二模型评审、文档写作等。
【路由原则】 按意图路由。文中列出的每个名称都是 skills-lock.json(已安装名册)中的一个条目,因此名册中的名称在本机上总能解析。 位于 ~/.claude/CLAUDE.md 的内核路由索引优先绑定。当内核指定了触发场景——委派、完成/卡住声明、验收不明确、重试、循环型工作、代码变更、输出形态——以内核的路由为准。其中部分技能仍在下方表格中列出,只是为了每个锁名在一处即可解析;该行是查找,不是第二意见。 最多两跳:using-skills → 领域路由器 → 成员技能。禁止从领域路由器内部回跳到这里。执行前阅读实时的 SKILL.md;绝不凭对旧名册的记忆行事。 模式列含义:Skill() = 模型可调用;manual = 内联阅读其 SKILL.md 或使用其 slash 命令;via-router = 通过指定的路由器进入。
【Hop 1:领域路由器】
- using-design-skills:任何视觉相关内容——网页、应用界面、HTML 交付物、图表、制品、动效,以及模块和 API 接口设计。模式 Skill()。
- using-workflows:循环型工作——审计、共识、分诊、计划→构建、生命周期、研究轮次。拥有 ~/.claude/workflows/ 中的配方;本文件不列出这些配方。模式 Skill()。
- using-tmux-agent-tools:将 CLI 作为 tmux worker 运行,或决定内联与 worker 的选择。模式 Skill()。
【流程:情境 → 交接 → 产物 → 循环】 文中强调这是条件性交接,不是流水线。只使用任务所需的阶段,且限定在用户授权的范围内。拥有流水线的领域路由器保留其流水线。循环型工作或命名配方交给 using-workflows,由其选择或绕过;仅有一个新评审者并不构成配方。不是每个技能都是一个链接:工具、生成器和约束集来自该映射。 资料给出若干情境对照(每行含 情境 / 交接 / 每步产物 / 循环闭合条件),例如:
- 新功能、验收不明确:unknowns-discovery(当其触发条件成立时)→ 针对设计问题做 prototype,或任务超出一个会话时用 wayfinder → implement(用户想要测试优先时用 tdd)→ 在任何完成声明前执行并引用一次检查(内核 Done 规则)→ 有风险或用户要求时做 defect-first-review。
- Bug 或回归:diagnosing-bugs(若存在大量竞争假设则改进入 using-workflows)→ 重跑原始场景 → 风险需要时对修复 diff 做 defect-first-review。
- 测试计划:内联编写用例 → 仅在授权执行时用 agent-browser(Web)或 agent-device(App)→ 出现 bug 则记 Bug 行;跟踪器问题 → triage。
- 暂停或交接:session-handoff;供 Codex 复用的知识 → shared-memory-intake(仅收件箱)。
【所有者指针】 某些技能的链路仍归其自身:全代码库深化 → improve-codebase-architecture;接口、领域或视觉设计 → using-design-skills;面向人的写作 → writing-artifacts;tmux workers → using-tmux-agent-tools;循环与配方 → using-workflows;技能编辑 → skill-creator(草稿、评估),然后在任何安装或部署前进行规则维护 §1(精确 diff、审批)。
【各类任务的技能对照】
- 构建前塑造想法:并行发散(adhd)、压力测试计划或决策(grilling)、情境模糊或跨域时选择流程(ask-nova,manual)、在陌生领域显现地图/领地差距(unknowns-discovery)、构建一次性原型(prototype)、把超出一个会话的工作排成决策票(wayfinder,manual)。
- 编写和修改代码:全代码库寻找深化机会(improve-codebase-architecture,manual)、设计深模块接口(codebase-design)、构建或打磨领域模型/CONTEXT.md/ADR(domain-modeling)、测试优先构建功能(tdd)。
- 诊断与验证:内联诊断困难 bug 或性能回归(diagnosing-bugs)、以缺陷优先只读方式审查 diff 的每个发现(defect-first-review)、对照 Web Interface Guidelines 审查 UI 代码(web-design-guidelines)。
- 委派与编排:编写任何 worker 简报 GOAL/ACCEPTANCE/REPORT(delegation-templates)、驱动 tmux workers(tmux-agent-tools,via-router)、规划并运行显式编排的智能体工作流(codex-dynamic-workflows)。
- 读取外部世界:将粘贴的 URL 读为干净 markdown(defuddle)、读取/填写/合并/生成 PDF(pdf)、针对一手资料调研并撰写(research)、驱动浏览器(agent-browser)、驱动 iOS/Android/macOS/TV 应用(agent-device)、读取或驱动 Grok Bot macOS 应用(using-grok-bot-app)。
- 面向人写作:把模糊主题变成成品交付物(writing-artifacts,入口)、编写仓库内软件文档 README/API/教程(documentation-writing)、在结构化之前挖掘原始碎片(writing-fragments,manual)、把原始素材逐段塑造成文章(writing-shape,manual)、把素材组装成节拍旅程(writing-beats,manual)、从任何文本中去除 AI 写作痕迹(stop-slop)。
- 视觉与 HTML 输出(全部经 using-design-skills):列出以便名称解析,而非绕过;由路由器选择所有者。相关技能包括 impeccable(方向权威:产品 UI、落地与营销页、重设计、打磨、评论)、apple-design(弹簧、手势、可中断动效)、hallmark(反套路绿色页面、审计、从 URL 或截图提取设计)、diagram-design(家庭风格类型化图表、mermaid 与 draw.io、PNG/SVG 导出)、data-report(CSV、Excel 或 JSON 转为可视化报告页)。
- 会话与集群维护:交接给新会话(session-handoff)、管理共享 Codex 记忆或向其提交发现(shared-memory-intake)、创建/编辑/评估技能(skill-creator)、让问题与外部 PR 走分诊流程(triage,manual)、为只有人能做的步骤生成 bash 向导(wizard)。
【插件与内置技能】 这些不在 skills-lock.json 中。仅当插件在 ~/.claude/settings.json 中启用且该技能出现在可用技能列表中时才列出;已禁用插件的技能不属于此。模式 plugin:<name> = 位于该插件缓存中;bundled = 随 Claude Code 一同提供。资料列出了 context-mode 插件下的多个 ctx 技能(context-mode、ctx-doctor、ctx-index、ctx-insight、ctx-purge、ctx-search、ctx-stats、ctx-upgrade)、ponytail 插件下的多个技能(ponytail、ponytail-audit、ponytail-debt、ponytail-gain、ponytail-help、ponytail-review),以及 Claude Code 内置技能(artifact-design、artifact-capabilities、artifact-diagramming、workflow-authoring、loop、claude-api)。其他已启用插件(code-review、commit-commands、pr-review-toolkit、session-report、frontend-design、security-guidance)在列表中带有各自的描述。规则文件(~/.agents/rules/*.md)不是技能;由内核路由它们。
【子智能体豁免】 执行单个被分配任务的 worker 不进入本路由器。调度方已经路由过;worker 遵循其简报。
【红旗提示】 文中列出若干常见误区:仅凭“这只是小问题,不用 skill”就绕开——领域明显时可直连,但实质性工作不得跳过路由;“我记得那支 skill 的内容”——成员会变化,先阅读实时 SKILL.md;“先做完再回头套流程”——对循环型或视觉型工作,路由器先选流程,事后套用会交付半成品。
【新鲜度自检】 本映射在最后一次编辑时与 skills-lock.json 匹配。当此处名称无法解析,或列表出现本映射遗漏的技能时,在信任前先确认,并给出了 diff 命令用于对比 SKILL.md 中引用的名称与 skill-lock.json 中的键。左列独有的名称属于插件/内置部分、模式词、规则名或陈旧引用;右列独有的名称是本映射尚未放置的已安装技能。
【没有匹配时】 不属于循环型、不属于视觉型、也无意向在上方:查看当前可用技能列表,然后内联处理。新的重复性意图应作为技能或配方的提案提交给用户。绝不内联临时编造一个路由器。