【Skill】Superpowers 常用命令与使用场景

更好的阅读体验：https://www.chongwenz.cn/tech/skill/Superpowers/

Superpowers 常用命令与使用场景

关注 Superpowers 有段日子了，今天终于抽空安装测试了一下，整理了一份常用命令笔记。

网上关于 Superpowers 的介绍和各类 Harness 框架的对比评测很多。但想知道它究竟好不好用、是否适配自己的项目，终究还是得亲手试过才知道。

开源地址：https://github.com/obra/superpowers

如何安装？给你的Agent说：

去 https://raw.githubusercontent.com/obra/superpowers/master/README.md 看看怎么安装，然后帮我装上

1. Superpowers 是什么

Superpowers 是一套面向多个 AI 编程工具的 skills 和工作流约束。它可以用于 Claude Code、Cursor、Codex、OpenCode、GitHub Copilot CLI、Gemini CLI 等工具。

简单来说，它是一堆 skill 的集合，通过 skill 约束强制 AI 遵守工程纪律。

它的作用是让这些 AI 在处理开发任务时更像按规范工作的工程助手，例如：

• 做新功能前先梳理需求和方案
• 改复杂内容前先写计划
• 遇到 bug 时先系统排查
• 需要时用并行 agent、worktree、review 流程

2. 触发方式

自动触发

当请求明显符合某个 skill 的用途时，Claude 通常会自动调用对应 skill。

例子：

• “帮我设计这个功能” →brainstorming
• “这个测试失败帮我排查” →systematic-debugging
• “先给我一个实现计划” →writing-plans
• “改完后帮我确认是不是真的完成” →verification-before-completion

手动触发

如果你想明确指定流程，可以直接点名或者使用/命令：

• 用 brainstorming 先想方案或/brainstorming
• 按 test-driven-development 来实现
• 先走 writing-plans，不要直接改代码

常用命令速查表

3. 常用命令与使用场景

需求澄清类

brainstorming

作用：在创造性任务开始前先梳理目标、边界和实现方案。
适用场景：

• 新功能设计
• 页面或交互方案比较
• 需求不清晰，需要先澄清再做
• 不想 Claude 直接开始改代码

示例：

• “先用brainstorming设计一下导出功能”

计划执行类

writing-plans

作用：在多步骤任务开始前先形成实现计划。
适用场景：

• 跨多个文件修改
• 新增一整套功能
• API、前端、测试联动
• 中大型重构

示例：

• “先用writing-plans给我出实现计划”

executing-plans

作用：按已经确定的计划执行实现。
适用场景：

• 计划已经写好
• 你希望按既定步骤推进
• 适合在新的会话里继续执行既有计划

示例：

• “按刚才的计划继续，用executing-plans执行”

质量保障类

systematic-debugging

作用：系统化排查 bug、失败测试和异常行为。
适用场景：

• 测试失败
• 程序行为和预期不一致
• 报错原因不明
• 不希望 Claude 直接猜测性修复

示例：

• “用systematic-debugging看下这个报错”

test-driven-development

作用：先定义测试或预期，再写实现。
适用场景：

• 新功能开发
• bugfix
• 回归风险高的逻辑改动
• 你希望实现结果可验证

示例：

• “按test-driven-development来修这个 bug”

verification-before-completion

作用：在宣称"完成"前，先做验证。
适用场景：

• 改完后需要确认测试通过
• 需要确认构建成功
• 不想只听到口头上的"修好了"

示例：

• “先用verification-before-completion验证，再告诉我结果”

代码审查类

requesting-code-review

作用：在完成阶段主动请求代码审查。
适用场景：

• 完成重要功能
• 完成一个里程碑步骤
• 合并前想做一次质量检查

示例：

• “这个功能做完后，用requesting-code-review再审一遍”

receiving-code-review

作用：收到 review 意见后，先评估建议是否成立，再修改。
适用场景：

• 你刚收到 code review comments
• feedback 不够清晰
• 不想机械照改

示例：

• “我收到 review 反馈了，先用receiving-code-review看看是否合理”

分支管理类

finishing-a-development-branch

作用：在工作完成后，决定如何收尾分支。
适用场景：

• 功能完成
• 测试通过
• 需要决定下一步是提 PR、合并还是清理

示例：

• “做完了，用finishing-a-development-branch看怎么收尾”

using-git-worktrees

作用：在隔离工作区中开展任务。
适用场景：

• 不想污染当前工作目录
• 需要并行处理多个任务
• 需要在独立环境中验证改动

示例：

• “这个功能我想在隔离 worktree 里做”

并行任务类

dispatching-parallel-agents

作用：将多个相互独立的任务分发给并行 agent。
适用场景：

• 前后端可独立探索
• 一个任务可拆成多个互不依赖的子任务
• 想加快检索、分析或实现速度

示例：

• “这个需求拆成几块，用并行 agent 一起做”

subagent-driven-development

作用：用多个子 agent 协作推进开发。
适用场景：

• 大任务拆分执行
• 测试、实现、探索可以并行
• 当前会话希望采用 agent 协作模式

其他工具类

update-config

作用：修改 Claude Code 的配置，例如.claude/settings.json。
适用场景：

• 配置 hooks
• 修改权限策略
• 设置环境变量
• 让某些行为以后自动执行

示例：

• “用update-config把这个检查配置成自动运行”

using-superpowers

作用：在开始任何对话时使用，建立如何查找和使用 skills 的规范，要求在任何响应（包括澄清问题）之前先调用 Skill 工具。

4. 推荐工作流

新功能开发

1. brainstorming
2. writing-plans
3. test-driven-development
4. verification-before-completion
5. requesting-code-review
6. finishing-a-development-branch

修 bug

1. systematic-debugging
2. test-driven-development
3. verification-before-completion
4. requesting-code-review（重要修复时）

先计划再实现

1. brainstorming
2. writing-plans
3. executing-plans

做完后收尾

1. verification-before-completion
2. requesting-code-review
3. finishing-a-development-branch

5. 什么时候建议手动指定 skill

建议你明确写出 skill 名称的情况：

• 你想强制先想方案，不要直接动手
• 你想强制先写计划
• 你想严格按 TDD 做
• 你要我在完成前必须跑验证
• 你想指定 review / 收尾流程
• 你想配置以后自动化执行的行为

6. 常用命令速查表

常用命令

其他命令

7. 一句话总结

Superpowers 的核心价值不在于"新增神奇能力"，而在于把 Agent 的做事方式变得更规范：

• 先思考
• 先计划
• 先调试
• 先验证
• 再收尾

要学习或测试 Superpowers，最简单的是亲自上手试试，先从一个空项目尝试吧，怎么折腾都没事儿。

附录：全技能一览

Superpowers 由以下 14 个 skills 组成，以下是官方原始 skill 的原版描述：