using-skills

using-skills

按意图路由。以下每个名称都是 skills-lock.json（已安装技能列表）中的条目，因此这里的名称在此机器上始终可解析。

内核路由索引 ~/.claude/CLAUDE.md 优先绑定。当内核指定某个触发条件——委派、声称已完成或受阻、验收条件不明确、重试、循环式工作、代码更改、输出格式——其路由优先。下面仍为其中一些技能保留了条目，以便所有锁定名称都能在一处查到；这些条目仅供查找，不代表第二种意见。

最多两跳：using-skills → 领域路由器 → 成员技能。切勿从领域路由器内部返回此处。行动前先阅读当前的 SKILL.md；切勿依据对旧技能列表的记忆采取行动。

Mode 列：Skill() = 可由模型调用 · manual = 内联阅读其 SKILL.md 或使用其斜杠命令 · via-router = 通过指定路由器进入

第 1 跳：领域路由器

路由器	适用情况	模式
using-design-skills	任何视觉相关任务：网页、应用屏幕、HTML 交付物、图表、制品、动效，以及模块和 API 接口设计	Skill()
using-workflows	循环式工作：审计、共识、分诊、计划→构建、生命周期、研究轮次。负责 ~/.claude/workflows/ 中的配方；本文件不列出这些配方	Skill()
using-tmux-agent-tools	将 CLI 作为 tmux 工作进程运行，或决定采用内联方式还是工作进程	Skill()

工作流：情况 → 移交 → 制品 → 循环

按条件移交，而非流水线。只在用户授权的范围内使用任务所需的阶段。负责某条流水线的领域路由器会自行处理该流水线。循环式工作或命名配方交给 using-workflows，由其决定采用还是跳过；仅有新的审查者并不意味着要使用配方。并非每项技能都是链接：工具、生成器和约束集都来自映射表。

情况	移交	每一步的制品	循环结束条件
新功能，验收条件不明确	unknowns-discovery（符合其触发条件时）→ 设计问题交给 prototype，规模太大、无法在一次会话中完成时交给 wayfinder → 实现（用户要求测试优先时使用 tdd）→ 在声称完成前执行检查并引用结果（内核 Done 规则）→ 风险较高或用户要求时使用 defect-first-review	已说明的默认值 → 设计答复或决策工单 → diff 和测试 → 引用的检查输出 → 发现项	修复发现项并重新验证；重复出现的发现项 → 设为门禁，或创建一条标明文件的待办事项
Bug 或回归问题	diagnosing-bugs（存在多个相互竞争的假设时，改为进入 using-workflows）→ 重新运行原始场景 → 风险较高时，对修复 diff 使用 defect-first-review	复现步骤和失败信号 → 修复和回归测试 → 重新运行原始场景 → 发现项	回归测试保留在代码库中
测试计划	内联编写测试用例 → 仅在获准执行时使用：agent-browser（Web）或 agent-device（应用）→ 发现 Bug → Bug 条目；跟踪器问题 → triage	测试用例 → 执行证据 → Bug 报告	遗漏的用例返回计划中
暂停或移交	session-handoff；可供 Codex 复用的知识 → shared-memory-intake（仅收件箱）	移交文档 → 收件箱条目	下一次会话从该文档开始

所有者指引（各自的处理链由其自行负责）：深化整个代码库 → improve-codebase-architecture；接口、领域或视觉设计 → using-design-skills；面向用户的写作 → writing-artifacts；tmux 工作进程 → using-tmux-agent-tools；循环和配方 → using-workflows；编辑技能 → skill-creator（起草、评估），然后在安装或部署前遵循规则 maintenance §1（精确 diff、审批）。

构思后再着手构建

我需要……	技能	模式
在不同认知框架下并行发散思考	adhd	Skill()
在多轮前沿推演中对计划或决策进行压力测试	grilling	Skill()
情况模糊或涉及多个领域时选择工作流	ask-nova	手动
在陌生领域中揭示地图与实际情况之间的差距	unknowns-discovery	Skill()
构建一次性原型，以解答设计问题	prototype	Skill()
将超出单次会话范围的工作规划为决策任务卡	wayfinder	手动

编写和修改代码

我需要……	技能	模式
在整个代码库中寻找深化改进的机会	improve-codebase-architecture	手动
设计深度模块接口	codebase-design	Skill()
构建或完善领域模型、CONTEXT.md、ADR	domain-modeling	Skill()
采用测试先行的方式构建功能	tdd	Skill()

诊断和验证

我需要……	技能	模式
就地诊断棘手的 bug 或性能回退	diagnosing-bugs	Skill()
以缺陷为先、只读地审查差异，并列出所有发现	defect-first-review	Skill()
根据 Web Interface Guidelines 审查 UI 代码	web-design-guidelines	Skill()

委派和编排

我需要……	技能	模式
编写任何工作者任务说明（GOAL/ACCEPTANCE/REPORT）	delegation-templates	Skill()
驱动 tmux 工作者：机制和封装工具	tmux-agent-tools	通过路由器
规划并运行明确编排的 Agent 工作流	codex-dynamic-workflows	Skill()

阅读外部内容

我需要……	技能	模式
将粘贴的网址读取为整洁的 Markdown	defuddle	Skill()
阅读、填写、合并或生成 PDF	pdf	Skill()
针对主要来源调查问题并撰写报告	research	Skill()
驱动浏览器：导航、填写表单、截图	agent-browser	Skill()
驱动 iOS、Android、macOS 或 TV 应用	agent-device	Skill()
阅读或驱动 Grok Bot macOS 应用（机器人、文件夹、对话记录）	using-grok-bot-app	Skill()

编写供人阅读的内容

我需要……	技能	模式
将模糊主题转化为完整交付成果（入口）	writing-artifacts	Skill()
编写仓库内的软件文档：README、API、教程	documentation-writing	Skill()
在构建任何结构之前挖掘原始片段	writing-fragments	手动
将原始素材逐段整理成文章	writing-shape	手动
将素材编排成一系列节拍	writing-beats	手动
去除任何文本中的 AI 写作模式	stop-slop	Skill()

视觉与 HTML 输出（均通过 using-design-skills）

列出这些名称是为了能解析它们，而非绕过路由器。由路由器选择负责的技能。

技能	负责范围
impeccable	方向决策权：产品 UI、落地页与营销页面、重新设计、润色、评审
apple-design	弹簧效果、手势、可中断动画
hallmark	避免套路化的全新页面、审计、从网址或截图提取设计
diagram-design	统一风格的类型化图表、mermaid 和 draw.io、PNG/SVG 导出
data-report	将 CSV、Excel 或 JSON 转化为可视化报告页面

会话与工具群维护

我需要……	技能	模式
移交给新的会话	session-handoff	Skill()
整理共享的 Codex 记忆，或向其中提交发现	shared-memory-intake	Skill()
创建、编辑或评估技能	skill-creator	Skill()
让问题和外部 PR 流转于各分诊角色之间	triage	手动
为仅能由人类完成的步骤生成 bash 向导	wizard	Skill()

车队依赖的插件和捆绑技能

不在 skills-lock.json 中。仅当插件在 ~/.claude/settings.json 中启用，且技能出现在可用技能列表中时才列出； 已禁用插件的技能不应列在这里。模式 plugin:<name> = 位于该插件的缓存中； bundled = 随 Claude Code 一同提供。

技能	来源	模式
context-mode	context-mode	plugin:context-mode
ctx-doctor	context-mode	plugin:context-mode
ctx-index	context-mode	plugin:context-mode
ctx-insight	context-mode	plugin:context-mode
ctx-purge	context-mode	plugin:context-mode
ctx-search	context-mode	plugin:context-mode
ctx-stats	context-mode	plugin:context-mode
ctx-upgrade	context-mode	plugin:context-mode
ponytail	ponytail	plugin:ponytail
ponytail-audit	ponytail	plugin:ponytail
ponytail-debt	ponytail	plugin:ponytail
ponytail-gain	ponytail	plugin:ponytail
ponytail-help	ponytail	plugin:ponytail
ponytail-review	ponytail	plugin:ponytail
artifact-design	Claude Code	bundled
artifact-capabilities	Claude Code	bundled
artifact-diagramming	Claude Code	bundled
workflow-authoring	Claude Code	bundled
loop	Claude Code	bundled
claude-api	Claude Code	bundled

其他已启用的插件（code-review、commit-commands、pr-review-toolkit、 session-report、frontend-design、security-guidance）也会显示在列表中， 并附有各自的说明。规则文件（~/.agents/rules/*.md）不是技能；内核会对其进行路由。

子 Agent 豁免

执行一项指定任务的工作者不会进入此路由器。调度器已经完成路由；工作者遵循其任务说明。

警示信号

若仍要继续使用某项技能，必须说明理由。

• 「這只是小問題，不用 skill」：领域明确时可以直接处理，但重大工作不得跳过路由。
• 「我記得那支 skill 的內容」：技能会变更。请先读取当前的 SKILL.md。
• 「先做完再回頭套流程」：对于循环式或视觉类工作，路由器会先选择流程。事后补流程会导致交付的工作半途而废。

新鲜度自检

此映射与最后编辑时的 skills-lock.json 一致。如果此处的名称无法解析，或列表中出现此映射未包含的技能，请先确认再信任此映射：

diff <(rg -o '`[a-z][a-z0-9-]+`' ~/.agents/skills/using-skills/SKILL.md | tr -d '`' | sort -u) \
     <(jq -r '.skills|keys[]' ~/.agents/.skill-lock.json | sort)

仅出现在左栏的名称属于插件/捆绑部分、模式词、规则名称或过时引用；请检查该部分之外的名称。仅出现在右栏的名称是已安装但此映射尚未归类的技能。

没有匹配项

不属于循环式工作、不是视觉类工作，也没有匹配上述意图：请检查当前可用技能列表，然后直接处理。新的常见意图应作为技能或配方提案提交给用户。切勿临时在行内编造路由器。