Superpowers 14个技能详细讲解

飞龙1477565746750
0 阅读5分钟

1️⃣ using-superpowers —— 技能系统入门向导

  • 定位：这是整个技能系统的"说明书"

  • 作用：告诉 AI 如何使用 Superpowers 技能系统

  • 关键点：

    • 介绍技能调用机制
    • 说明如何识别触发条件
    • 指导何时使用哪个技能
    • 像是餐厅的"点餐指南"

2️⃣ brainstorming —— 头脑风暴，先设计再编码

  • 定位：需求理解与方案设计

  • 作用：在动手写代码前，先搞清楚要做什么、怎么做

  • 工作流：

    1. 理解需求 → 2. 探索代码库 → 3. 提出多种方案 → 4. 选择最佳方案 → 5. 产出规格文档

  • 核心理念： "先想清楚，再动手"

  • 比喻：像是建筑师画蓝图，而不是直接砌墙

3️⃣ writing-plans —— 写计划，任务拆解专家

  • 定位：将大任务拆成可执行的小步骤

  • 作用：把复杂的需求变成清晰的任务清单

  • 关键点：

    • 每个任务都要有明确的验收标准
    • 任务之间有先后依赖关系
    • 每个任务足够小，可以在一次会话内完成

  • 比喻：像是导游制定的旅行路线图，每天去哪、看什么都清清楚楚

4️⃣ subagent-driven-development —— 子代理驱动开发

  • 定位：专业的"包工头"，负责派活和验收

  • 作用：每个任务派一个专门的子代理去做

  • 两阶段审查机制：

    1. 规格合规审查：检查子代理是否按计划做事
    2. 代码质量审查：检查代码写得好不好

  • 核心理念： "专业分工，专人专事"

  • 比喻：像是项目经理，每个模块派专门的工程师去做

5️⃣ test-driven-development —— 测试驱动开发

  • 定位：质量守门员

  • 作用：先写测试，再写代码，确保代码质量

  • 红-绿-重构工作流：

    1. 红：写测试，运行，看它失败
    2. 绿：写代码，让测试通过
    3. 重构：优化代码，保持测试通过

  • 关键点： "没有测试的代码，就是不安全的代码"

6️⃣ executing-plans —— 执行计划，按部就班

  • 定位：计划的执行者

  • 作用：按照 writing-plans 写好的计划，一步一步执行

  • 工作方式：

    • 逐个完成任务
    • 每个任务完成后都要验证
    • 记录完成情况

  • 关键点： "不跳步，不偷工，一个一个来"

7️⃣ requesting-code-review —— 请求代码审查

  • 定位：主动寻求反馈

  • 作用：代码写完后，主动请求审查

  • 审查内容：

    • 代码是否符合规范
    • 逻辑是否正确
    • 有没有潜在的 bug

  • 比喻：像是学生写完作业，请老师批改

8️⃣ receiving-code-review —— 接收代码审查

  • 定位：虚心接受反馈

  • 作用：收到审查意见后，认真修改

  • 关键点：

    • 不要辩解，先理解意见
    • 逐条修改
    • 修改后再次验证

  • 核心理念： "审查意见是礼物，不是批评"

9️⃣ finishing-a-development-branch —— 完成开发分支

  • 定位：项目收尾专家

  • 作用：功能开发完成后，进行收尾工作

  • 工作内容：

    • 运行完整测试套件
    • 检查代码质量
    • 准备合并到主分支
    • 清理临时文件

  • 关键点： "善始善终，不留尾巴"

🔟 systematic-debugging —— 系统调试，科学破案

  • 定位：Bug 侦探

  • 作用：用科学的方法定位和修复 bug

  • 调试流程：

    1. 复现问题 → 2. 收集证据 → 3. 形成假设 → 4. 验证假设 → 5. 修复问题 → 6. 防止复发

  • 核心理念： "不要瞎猜，用证据说话"

  • 比喻：像是福尔摩斯破案，靠线索和推理

1️⃣1️⃣ writing-skills —— 编写技能的技能

  • 定位：技能创作者

  • 作用：教你如何写一个新的 Superpowers 技能

  • 技能设计原则：

    • CSO（Claude Search Optimization） ：description 只写触发条件
    • 清晰的使用场景
    • 具体的操作步骤
    • 正反例子对比

  • 关键点： "技能也是代码，需要精心设计"

1️⃣2️⃣ dispatching-parallel-agents —— 并行派遣代理

  • 定位：多任务并行处理

  • 作用：当有多个独立任务时，同时派多个代理去做

  • 使用场景：

    • 3个以上测试文件同时失败
    • 多个子系统独立出问题
    • 任务之间没有依赖关系

  • 核心理念： "能并行的，就不要串行"

  • 比喻：像是同时派多个快递员送不同的包裹

1️⃣3️⃣ using-git-worktrees —— 使用 Git 工作树

  • 定位：环境隔离专家

  • 作用：创建独立的工作环境，避免不同分支相互干扰

  • 工作原理：

    • Git worktree 允许在同一仓库的多个分支上同时工作
    • 每个分支有独立的工作目录
    • 共享同一个 Git 仓库

  • 关键点：

    • 优先使用 .worktrees/ 目录
    • 必须确保目录被 gitignore 忽略
    • 创建后自动运行项目设置和测试

  • 比喻：像是给每个任务准备一个独立的工作台

1️⃣4️⃣ verification-before-completion —— 完成前验证

  • 定位：事实核查员

  • 作用：在声称工作完成前，必须先验证

  • 铁律： "没有验证证据，就不能声称完成"

  • 验证流程：

    1. 确定用什么命令验证
    2. 运行完整命令
    3. 读取输出，检查退出码
    4. 确认输出支持你的声明
    5. 只有这样，才能声称完成

  • 核心理念： "证据胜于雄辩"

  • 比喻：像是考试，必须交卷且成绩合格才算通过

🔗 技能之间的关系

这些技能不是孤立的，它们形成了一个完整的开发 workflow：

  1. 需求 → brainstorming：理解需求，设计方案
  2. 方案 → writing-plans：拆解成任务
  3. 任务 → using-git-worktrees：创建隔离环境
  4. 环境 → subagent-driven-development / executing-plans：执行任务
  5. 执行中 → test-driven-development：保证质量
  6. 遇到问题 → systematic-debugging：调试修复
  7. 完成后 → verification-before-completion：验证结果
  8. 验证通过 → requesting-code-review：请求审查
  9. 审查通过 → receiving-code-review：接收反馈（如有）
  10. 最终 → finishing-a-development-branch：收尾完成

💡 核心设计理念

Superpowers 的技能设计有几个核心理念：

  1. 先设计，后编码：brainstorming + writing-plans
  2. 质量第一：test-driven-development + verification-before-completion
  3. 专业分工：subagent-driven-development + dispatching-parallel-agents
  4. 科学方法：systematic-debugging
  5. 证据为王：verification-before-completion

这就是 Superpowers 的 14 个核心技能！每个技能都有明确的定位和作用，组合在一起形成了一套完整的、高质量的软件开发 workflow。

avatar
文章
阅读
粉丝