Superpowers的技能系统

一、技能系统是什么？

简单说，技能系统就是一套"工作手册" ，告诉 AI 怎么规范地干活。

就像一个公司的员工手册：

• 告诉员工遇到什么情况该怎么做
• 有流程图、检查表
• 有常见问题和注意事项

Superpowers 的技能系统就是给 AI 用的"员工手册"。

---

二、一个技能长什么样？

每个技能就是一个文件夹，里面有个 SKILL.md 文件。

比如 test-driven-development 技能：

Plain Text

skills/test-driven-development/
└── SKILL.md  # 这就是技能文件

打开 SKILL.md 看看，结构很简单：

YAML

---
name: test-driven-development
description: Use when implementing any feature or bugfix, before writing implementation code
---

# Test-Driven Development (TDD)

## Overview
先写测试，再写代码...

## When to Use
什么时候用这个技能...

## Red-Green-Refactor
具体怎么操作...

## Common Mistakes
常见错误...

就这么简单！

---

三、技能系统有哪些技能？

Superpowers 有 14 个技能，分为几类：

1. 工作流技能（最核心）

这些技能组成完整的开发流程：

• brainstorming - 先做设计，再写代码
• writing-plans - 把任务拆成小步骤
• subagent-driven-development - 每任务派个新助手
• test-driven-development - 先写测试，再写代码

2. 辅助技能

• systematic-debugging - 怎么调试
• requesting-code-review - 怎么请求代码审查
• receiving-code-review - 怎么接收代码审查
• finishing-a-development-branch - 怎么完成开发分支

3. 其他技能

• using-superpowers - 入口技能（告诉 AI 怎么用技能系统）
• writing-skills - 怎么创建新技能
• verification-before-completion - 完成前怎么验证
• using-git-worktrees - 怎么用 Git 工作树
• dispatching-parallel-agents - 怎么并行派遣代理

---

四、技能系统怎么用？（实际例子）

假设你说："帮我做一个用户登录功能"

AI 的反应：

1. 先看 using-superpowers（Hook 已经注入了）

   • "哦，有技能系统，我应该用它"

2. 扫描所有技能的 description

   • brainstorming 的 description: "Use before any creative work..."
   • "这个匹配！我应该先用 brainstorming"

3. 加载 brainstorming 技能

   • 读取完整的 brainstorming/SKILL.md
   • "哦，原来要先问问题、做设计..."

4. 执行 brainstorming 技能

   • 问："登录方式支持哪些？"
   • 问："密码怎么存储？"
   • 做设计文档
   • ...

5. brainstorming 完成后

   • 继续扫描 description
   • writing-plans 的 description: "Use when you have a spec..."
   • "这个匹配！"

6. 加载 writing-plans 技能

   • 读取完整的 writing-plans/SKILL.md
   • "哦，原来要把任务拆成小步骤..."

7. 以此类推...

---

五、技能文件里有什么？

打开任何一个技能文件，你会看到：

1. YAML Frontmatter（最上面的两行）

YAML

---
name: skill-name
description: Use when [什么时候用这个技能]
---

• name：技能的名字
• description：告诉 AI"什么时候用这个技能"

2. 正文内容

Markdown

# 技能名称

## Overview
一句话说明这个技能是干什么的

## When to Use
什么时候用，什么时候不用

## （具体内容）
比如流程图、检查表、步骤...

## Common Mistakes
常见错误和怎么避免

---

六、总结

技能系统就是：

1. 一套"工作手册" （14 个技能）
2. 每个技能是一个文件夹，里面有 SKILL.md
3. AI 通过 description 匹配找到适用的技能
4. 加载完整的技能内容，然后按照执行