using-superpowers

using-superpowers Skill 多维度简评

综合评分：9.4 / 10 ⭐⭐⭐⭐⭐ 类别：元技能 / 软件工程方法论 仓库：obra/superpowers 维护者：Jesse Vincent / Prime Radiant GitHub Trending 霸榜 · 社区誉为”改变开发者社区的项目”

一、核心定位与价值

using-superpowers 是 Superpowers 14 个 Skills 中的元技能（Meta Skill）——它本身不解决具体问题，而是规定 Claude 在何时调用哪个 Skill。

关键原则：“IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.” （如果某个技能适用于你的任务，你没有选择——你必须使用它。这不容谈判，无法合理化逃避。）

完整 Superpowers Skill 列表（14 个）

二、核心机制详解

2.1 1% 触发原则

“如果某个技能有 1% 概率适用于你的任务，你必须调用它。”

digraph skill_flow {
  "User message received" [shape=doublecircle];
  "Might any skill apply?" [shape=diamond];
  "Invoke Skill tool" [shape=box];
  "Announce: Using [skill] to [purpose]" [shape=box];
  "Has checklist?" [shape=diamond];
  "Create TodoWrite todo per item" [shape=box];
  "Follow skill exactly" [shape=box];

  User -> "Might apply?" -- "1%+ chance" -> "Invoke Skill tool"
  "Invoke Skill tool" -> "Announce usage"
  "Announce usage" -> "Has checklist?"
  "Has checklist?" -- "yes" -> "Create TodoWrite per item"
  "Has checklist?" -- "no" -> "Follow skill exactly"
  "Create TodoWrite per item" -> "Follow skill exactly"
}

含义：

• 不需要确认”是否真的需要”
• 不用分析”可能性多大”
• 不用争论”是否过度”
• 1% 概率 = 必须用

2.2 调用流程

[1] 用户消息进入
   ↓
[2] 扫描所有 Skills，判断 1%+ 适用
   ↓
[3] 调用 Skill 工具，加载完整 SKILL.md
   ↓
[4] 公告：Using [skill] to [purpose]
   ↓
[5] 如果 Skill 有 checklist：创建 TodoWrite，每项一个 todo
   ↓
[6] 严格按照 Skill 指令执行

关键：announce 是必须的一步——Claude 不会偷偷使用 Skill，会主动告诉用户”我现在在用 X Skill”。

2.3 协作方式

# Claude Code 内部实现
def handle_user_message(message):
    # 1. 找到所有可能适用的 skills
    applicable = []
    for skill in ALL_SKILLS:
        if skill.matches(message, threshold=0.01):
            applicable.append(skill)
    
    # 2. 按优先级排序
    applicable.sort(key=lambda s: s.priority, reverse=True)
    
    # 3. 加载第一个
    primary = applicable[0]
    announce(f"Using {primary.name} to {primary.purpose}")
    
    # 4. 如果有 checklist，创建 todo
    if primary.checklist:
        for item in primary.checklist:
            create_todo(item)
    
    # 5. 执行
    return execute_skill(primary, message)

三、强制场景映射

3.1 何时用 brainstorming

触发条件：任何”创造性”工作之前

• “添加 X 功能”
• “构建 Y 组件”
• “修改 Z 行为”
• “Let’s make a …”

不适用：纯查询、配置修改

3.2 何时用 writing-plans

触发条件：需求明确后，接触代码前

• “我有个 spec，要开始实现”
• “文档在这里，开始干”
• “实施计划准备好了”

3.3 何时用 test-driven-development

触发条件：任何实现代码前

• “写一个新函数”
• “修一个 bug”
• “重构 X”

铁律：NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST

3.4 何时用 systematic-debugging

触发条件：

• 遇到任何 bug
• 测试失败
• 意外行为
• 在提出任何修复之前

铁律：NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST

3.5 何时用 verification-before-completion

触发条件：

• 准备宣称工作”完成”
• 准备提交 / 创建 PR
• 准备向用户报告结果

铁律：EVIDENCE BEFORE ASSERTIONS（证据先于断言）

3.6 何时用 using-git-worktrees

触发条件：

• 开始需要与当前工作区隔离的功能
• 执行实施计划前
• 多分支并行开发

四、强制流程示例

4.1 完整需求 → 上线流程

用户："Let's make a React todo list"

Step 1: using-superpowers 自动触发
  ↓
Step 2: brainstorming 启动
  → "你的 todo 是个人用还是团队用？"
  → "需要持久化吗？"
  → "偏好哪个状态管理库？"
  → "设计 API 形如 [show mock]？"
  ↓ 用户确认设计
Step 3: writing-plans 启动
  → 输出 12 个 2-5 分钟任务
  → 每个任务含：文件、测试、实现
  ↓ 用户批准计划
Step 4: using-git-worktrees
  → 创建 .worktrees/feature-todo-list
  ↓
Step 5: subagent-driven-development
  → 每个任务派新子代理
  → 两阶段审查（spec compliance + code quality）
  ↓
Step 6: test-driven-development (每个任务内)
  → RED: 写测试看失败
  → GREEN: 写最小代码
  → REFACTOR: 改进设计
  ↓
Step 7: requesting-code-review
  → 每 3 个任务请用户审查
  ↓
Step 8: verification-before-completion
  → 运行 npm test
  → 看到全部通过
  → 看到覆盖率 > 80%
  ↓
Step 9: finishing-a-development-branch
  → 选项 1: 本地合并
  → 选项 2: 推送 + PR
  → 选项 3: 保留
  → 选项 4: 丢弃
  ↓
Step 10: 清理 worktree

4.2 Bug 修复流程

用户："登录后页面空白"

Step 1: using-superpowers
  ↓
Step 2: systematic-debugging
  Phase 1: 收集症状
  → 浏览器 console 报什么？
  → 哪个版本开始？
  → 在哪个浏览器？
  Phase 2: 生成假设
  → H1: 路由问题
  → H2: 状态管理问题
  → H3: 认证 token 失效
  Phase 3: 验证假设
  → 在 console 打印 state
  → 检查 network 请求
  → 检查 localStorage token
  Phase 4: 根因
  → "找到了：token 过期但没刷新"
  ↓
Step 3: test-driven-development
  → RED: 写测试模拟 token 过期
  → GREEN: 写刷新逻辑
  → REFACTOR: 清理
  ↓
Step 4: verification-before-completion
  → npm test 通过
  → 手动复现：登录 → 等 1 小时 → 不再空白

五、与其他 Skills 配合

5.1 Superpowers 内部的”流水线”

brainstorming → writing-plans → using-git-worktrees
  ↓
subagent-driven-development (or executing-plans)
  ↓
test-driven-development (per task)
  ↓
requesting-code-review (per 3 tasks)
  ↓
verification-before-completion (final)
  ↓
finishing-a-development-branch (cleanup)

5.2 与其他生态配合

5.3 三栈组合

# CLAUDE.md
## 工作流路由
- 复杂需求 → OpenSpec（创建 proposal + spec）
- 实施计划 → Superpowers writing-plans
- 代码纪律 → Superpowers TDD
- 调试 → Superpowers systematic-debugging
- 验证 → Superpowers verification-before-completion

六、5 条反合理化

七、5 条实战技巧

1. CLAUDE.md 中显式路由：避免 superpowers 与 OpenSpec 冲突
2. 一个 task 一个 subagent：避免上下文污染
3. 每个 task 都跑 verification：不要积累到最后
4. 定期 git rebase worktree：保持主分支干净
5. 不要跳过 brainstorming：哪怕只是问 1 个问题

八、Q&A

Q: 必须订阅 Claude Code 吗？ A: 最佳体验是 Claude Code + Opus 模型。其他 LLM 也可借鉴。

Q: 跟 OpenSpec 冲突吗？ A: 是。两者都管”规划”。建议在 CLAUDE.md 中选其一。

Q: 适合小项目吗？ A: 适合。/using-superpowers 不增加代码量。

Q: 适合纯非技术任务吗？ A: brainstorming / systematic-debugging / verification 也适用非技术。

Q: 跟 ECC 的 verification-loop 重复吗？ A: 互补。ECC 是自动脚本；superpowers 是方法论。

Q: 学习曲线？ A: 1 周适应，2 周内化，1 月变本能。

Q: 中文支持？ A: 完美。Skill 触发逻辑与语言无关。

九、真实战绩

来源：obra/superpowers 社区统计

十、踩坑案例

案例 1：跳过 brainstorming

现象：直接动手 → 实现 → 3 周后废弃。 解决：永远先 brainstorming，哪怕 5 分钟。

案例 2：没写 plan 直接写代码

现象：写到一半发现架构错。 解决：writing-plans 强制 2-5 分钟任务切分。

案例 3：没 TDD 直接写实现

现象：PR 提交后回归测试失败 5 个。 解决：TDD RED-GREEN-REFACTOR。

案例 4：没 systematic-debugging 直接修

现象：试了 3 个 fix 都没用。 解决：先 5 Whys，找到根因再修。

案例 5：没 verification 宣称完成

现象：“应该通过了” → 实际没通过。 解决：运行命令 → 看到输出 → 才说完成。

案例 6：worktree 用完不清理

现象：3 个月后 10 个 worktree 残留。 解决：finishing-a-development-branch 强制清理。

案例 7：subagent context 污染

现象：主 session 上下文爆。 解决：每个 task 派全新 subagent。

十一、安装

# Claude Code
/plugin marketplace add obra/superpowers
/plugin install superpowers@claude-plugins-official

# 通用
npx skills add obra/superpowers --skill using-superpowers

# Codex / Cursor / Copilot CLI 也支持
# 见 https://github.com/obra/superpowers/blob/main/docs/environments.md

11.1 在 CLAUDE.md 中显式启用

# CLAUDE.md

## Superpowers 工作流
- 任何新功能：从 brainstorming 开始
- 实现前必走 TDD
- 修 bug 必走 systematic-debugging
- 完成前必走 verification-before-completion
- 多任务用 using-git-worktrees

十二、总结

核心价值：

• 元技能：强制 Claude 正确使用所有 Skill
• 14 个 Skill 的”调度器”
• 1% 触发原则
• 完整的工程纪律流程

适用人群：

• 所有用 Claude Code / Cursor 写代码的人
• 团队 Lead（建立团队纪律）
• 复杂项目维护者
• 想要”工程化 AI”的工程师

投入产出比：⭐⭐⭐⭐⭐（5/5）—— 所有 AI 编程必装。

何时不要用：

• 纯对话 / 写作（用其它 Skill）
• 临时一次性脚本
• 已经非常熟悉 Claude 4 的提示

配套文档：brainstorming 头脑风暴 | TDD | systematic-debugging

参考资料

1. obra/superpowers GitHub 仓库
2. Cialdini《影响力》心理学原理
3. Anthropic Claude Code Skills 文档
4. 沃顿商学院 LLM 说服力研究报告