用途
本文档是 agi-super-team 技能库的入门指南，用于规范 AI 助手在使用技能（Skills）时应遵循的流程。其目标是确保助手在开始任何任务前先查找并读取相关技能，避免重复已解决的问题或重犯已知错误。
关键规则
- 在宣布使用某个技能之前，必须先用 Read 工具读取该技能。会话启动钩子（session-start hook）不会替你读取技能；未调用 Read 就宣布使用等于说谎。
- 遵循强制工作流：编码前先头脑风暴；在任何任务前先检查是否有可用技能。
- 为清单创建 TodoWrite 待办事项。仅靠脑内记忆会导致步骤被跳过。
强制工作流：任何任务之前
- 在会话开始时检查技能列表，或运行
find-skills [PATTERN]进行过滤。 - 如果存在相关技能，必须使用它：
- 使用 Read 工具读取完整路径：
${SUPERPOWERS_SKILLS_ROOT}/skills/category/skill-name/SKILL.md - 读取整个文件，而不只是 frontmatter
- 宣布：“I've read [Skill Name] skill and I'm using it to [purpose]”
- 严格遵循该技能
- 使用 Read 工具读取完整路径：
不要为自己找理由：
- “我记得这个技能”——技能会演进，要读取当前版本。
- “会话启动时已经展示给我了”——那只是 using-skills/SKILL.md，仍需读取实际技能。
- “这不算一个任务”——它算。要查找并读取技能。
原因：技能记录了经过验证的技术，可节省时间并防止错误。不使用可用技能意味着重复已解决的问题、犯已知的错误。如果任务存在对应技能，你必须使用它，否则任务会失败。
带清单的技能
如果某个技能包含清单，你必须为每一项创建 TodoWrite 待办事项。
不要：
- 在脑中过一遍清单
- 为“节省时间”而跳过创建待办
- 把多个条目合并成一个待办
- 未实际执行就标记完成
原因：没有 TodoWrite 跟踪的清单会导致步骤被跳过，每次都是如此。TodoWrite 的开销相比漏掉步骤的代价微不足道。
示例：skills/testing/test-driven-development/SKILL.md、skills/debugging/systematic-debugging/SKILL.md、skills/meta/writing-skills/SKILL.md
宣布技能使用
用 Read 工具读取技能后，宣布你正在使用它：
“I've read the [Skill Name] skill and I'm using it to [what you're doing].”
示例：
- “I've read the Brainstorming skill and I'm using it to refine your idea into a design.”
- “I've read the Test-Driven Development skill and I'm using it to implement this feature.”
- “I've read the Systematic Debugging skill and I'm using it to find the root cause.”
原因：透明性有助于人类伙伴理解你的过程并尽早发现错误，同时也确认你确实读取了该技能。
如何读取技能
每个技能都有相同的结构：
- Frontmatter——
when_to_use告诉你该技能是否匹配你的情况 - Overview——用 1-2 句话说明核心原则
- Quick Reference——扫描你需要的具体模式
- Implementation——完整细节与示例
- Supporting files——仅在实现时加载
许多技能包含刚性规则（TDD、调试、验证），要严格遵循，不要擅自调整而丢掉纪律。
有些技能是灵活模式（架构、命名），可将核心原则适配到你的上下文。技能本身会告诉你它属于哪一类。
指令 ≠ 允许跳过工作流
人类伙伴的具体指令描述的是做什么（WHAT），而不是怎么做（HOW）。
“Add X”“Fix Y”是目标，不是允许跳过头脑风暴、TDD 或 RED-GREEN-REFACTOR 的许可。
危险信号：“指令很具体” • “看起来很简单” • “工作流是杀鸡用牛刀”
原因：具体指令意味着需求清晰，而这正是工作流最重要的时刻。在“简单”任务上跳过流程，正是简单任务变成复杂问题的原因。
总结
开始任何任务时：
- 运行
find-skills检查是否有相关技能 - 如果存在相关技能 → 用 Read 工具读取完整路径（包含
/SKILL.md） - 宣布你正在使用它
- 遵循它的内容
- 技能有清单？为每一项创建 TodoWrite 待办
找到相关技能 = 必须读取并使用它，而非可选。