Getting Started with Skills

开始使用 Skills

关键规则

1. 宣布使用技能前，先使用 Read 工具。 会话启动钩子不会替你读取技能。未调用 Read 就宣布使用技能 = 撒谎。

2. 遵循强制工作流。 编码前先进行头脑风暴。执行任何任务前都要检查技能。

3. 为检查清单创建 TodoWrite 待办事项。 凭记忆跟踪 = 步骤会被遗漏。每次都要这样做。

强制工作流：执行任何任务前

1. 检查技能列表：在会话开始时检查，或运行 find-skills [PATTERN] 进行筛选。

2. 如果存在相关技能，你必须使用：

• 使用 Read 工具读取完整路径：${SUPERPOWERS_SKILLS_ROOT}/skills/category/skill-name/SKILL.md
• 阅读整个文件，而不仅仅是 frontmatter
• 宣布：“我已阅读 [Skill Name] 技能，并将使用它来 [purpose]”
• 严格遵循技能说明

不要找借口：

• “我记得这个技能”——技能会不断更新。请阅读当前版本。
• “会话启动时已经显示过了”——那只是使用了 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 工具阅读技能后，宣布你正在使用它：

“我已阅读 [Skill Name] 技能，并将使用它来 [你要做的事]。”

示例：

• “我已阅读 Brainstorming 技能，并将使用它来将你的想法完善为设计方案。”
• “我已阅读 Test-Driven Development 技能，并将使用它来实现此功能。”
• “我已阅读 Systematic Debugging 技能，并将使用它来查找根本原因。”

为什么： 透明有助于人类协作者了解你的处理过程并及早发现问题，也能确认你确实阅读了技能。

如何阅读技能

每项技能的结构都相同：

1. Frontmatter——when_to_use 会说明此技能是否适用于当前情况
2. 概述——用 1-2 句话说明核心原则
3. 快速参考——查找与你遇到的情况相关的模式
4. 实现细节——完整细节和示例
5. 支持文件——仅在实施时加载

许多技能包含严格规则（TDD、调试、验证）。 请严格遵循，不要偏离这些规范。

有些技能是灵活模式（架构、命名）。 可根据上下文调整核心原则。

技能本身会说明属于哪种类型。

指示 ≠ 跳过工作流的许可

人类协作者的具体指示说明要做什么，而不是如何做。

“添加 X”“修复 Y” = 目标，不代表可以跳过头脑风暴、TDD 或 RED-GREEN-REFACTOR。

警示信号：“指示很具体” • “看起来很简单” • “工作流太繁琐”

为什么： 具体指示意味着需求清晰，而这正是工作流最重要的时候。在“简单”任务上跳过流程，正是简单任务演变成复杂问题的原因。

总结

开始任何任务时：

1. 运行 find-skills，检查是否有相关技能
2. 如果有相关技能 → 使用 Read 工具读取完整路径（包含 /SKILL.md）
3. 宣布你正在使用该技能
4. 遵循技能说明

技能包含检查清单？ 为每一项创建 TodoWrite 待办事项。

发现相关技能 = 必须阅读并使用，不可选择跳过。