22K Star!这个插件让Claude Code从＂初级码农＂变＂资深架构师＂

GitHub热榜 | 强制TDD | 子代理驱动开发 | 20+核心技能 | MIT开源

💥 Claude Code的致命问题:跳过步骤,直接开干

你用Claude Code写过代码吗?

如果用过,一定遇到过这些问题:

问题1:不写测试

你:"帮我实现用户登录功能"
Claude:开始写代码...写完了!
你:"测试呢?"
Claude:啊对...我补一下...

问题2:没有规划

你:"重构一下数据库迁移"
Claude:好的,我看看...改这个文件...
你:"还有7个文件没改!"
Claude:抱歉,我再看看...

问题3:调试靠猜

你:"这个bug怎么回事?"
Claude:我试试改这里...不行?那试试那里...
你:"能不能先找原因?!"
Claude:好吧...

问题4:直接开写

你:"做个邮件验证系统"
Claude:我直接写代码了!
你:"等等!我还没说需求细节!"
Claude:那我重写...

问题的根源:

Claude很聪明,但没有工程纪律。

就像一个聪明但没经验的初级工程师:

• • 能写代码,但不知道该遵循什么流程
• • 想帮忙,但不知道什么时候该停下来问问题
• • 会调试,但习惯瞎猜而不是系统分析

现在,一个GitHub开源项目彻底解决了这个问题:

Superpowers

22K Star | 997 Forks | MIT开源

给Claude Code装上”工程师大脑”,强制执行专业开发流程!

一、Superpowers到底做了什么?

🎯 核心理念:把工程纪律变成强制流程

不是”建议Claude这么做”

而是”Claude必须这么做,否则不让你继续”

完整工作流(7步强制执行)

1. 头脑风暴(brainstorming)
   ❌ 禁止:直接写代码
   ✅ 必须:问清需求,分块展示设计

2. Git工作树(using-git-worktrees)
   ❌ 禁止:在主分支瞎改
   ✅ 必须:新分支隔离开发

3. 写计划(writing-plans)
   ❌ 禁止:想到哪写到哪
   ✅ 必须:拆成2-5分钟小任务

4. 子代理驱动(subagent-driven-development)
   ❌ 禁止:一个agent干所有事
   ✅ 必须:每个任务独立agent+双重审查

5. TDD(test-driven-development)
   ❌ 禁止:先写代码再补测试
   ✅ 必须:红绿重构循环

6. 代码审查(requesting-code-review)
   ❌ 禁止:写完就算完
   ✅ 必须:任务间强制review

7. 收尾(finishing-a-development-branch)
   ❌ 禁止:随便merge
   ✅ 必须:测试通过+选择合并策略

**关键:**这不是建议,是强制执行的工作流!

二、20+核心技能,覆盖开发全流程

🧪 测试技能

test-driven-development

强制RED-GREEN-REFACTOR循环:
1. 写失败测试
2. 看它失败
3. 写最少代码让它通过
4. 看它通过
5. 重构
6. 提交

如果先写代码,删掉重来!

🐛 调试技能

systematic-debugging(系统化调试)

4阶段强制流程:
1. 根因调查 - 追溯到源头
2. 模式分析 - 其他地方有吗?
3. 假设验证 - 有证据才行
4. 实施修复 - 理解了再改

禁止瞎猜!

verification-before-completion

声称"修好了"之前:
✅ 运行验证命令
✅ 提供具体证据
✅ 确认所有测试通过

否则不算完成!

🤝 协作技能

brainstorming(头脑风暴)

苏格拉底式提问:
- 你真正想解决什么问题?
- 有其他方案吗?
- 这个方案的权衡是什么?

设计分块展示,逐段确认

禁止直接写代码!

writing-plans(写计划)

详细实施计划必须包含:
✅ 确切文件路径
✅ 完整代码示例
✅ 验证步骤
✅ 预期结果
✅ Git commit信息

任务大小:2-5分钟

subagent-driven-development(子代理驱动)

每个任务:
1. 启动独立子agent
2. 双重审查:
   - 第一轮:符合规范吗?
   - 第二轮:代码质量如何?
3. 问题分级:Critical立即阻塞

持续集成思想应用于AI!

🔧 Git技能

using-git-worktrees(使用Git工作树)

隔离开发环境:
1. 新分支独立目录
2. 运行项目设置
3. 验证测试基准
4. 并行开发不干扰

finishing-a-development-branch(收尾)

完成时选项:
- Merge到主分支
- 创建PR
- 保留继续开发
- 丢弃工作

清理工作树

📝 元技能

writing-skills(写技能)

教Claude如何创造新技能:
1. 遵循TDD原则
2. 测试失败场景
3. 写技能文档
4. 验证agent遵守
5. 持续改进

递归学习能力!

三、实战案例:构建邮件验证系统

传统Claude Code工作流

你:"做个邮件验证系统"

Claude:好的!我开始写代码了!
[直接生成EmailValidator.js]

你:"测试呢?"
Claude:哦对,我补上...
[补充一些测试]

你:"这个边界情况怎么办?"
Claude:没想到...我改改...
[又改了一堆代码]

结果:代码写了3遍,测试覆盖率60%,还有bug

Superpowers工作流

# 第1步:头脑风暴
/superpowers:brainstorm

Claude问:
- 需要验证哪些邮箱格式?
- RFC 5322完整遵循还是实用主义?
- 需要DNS验证吗?
- 性能要求是什么?
- 错误提示需要国际化吗?

你回答后,Claude展示设计(分段):
📋 第1部分:核心验证逻辑
[详细设计]
确认吗? (y/n)

📋 第2部分:错误处理
[详细设计]
确认吗? (y/n)

...

# 第2步:写计划
/superpowers:write-plan

Claude生成implementation-plan.md:
## 任务1:创建测试基础设施
文件: tests/EmailValidator.test.js
代码: [完整测试框架]
验证: npm test通过
时间: 3分钟
Commit: "test: Add email validator test framework"

## 任务2:实现基本格式验证
文件: src/EmailValidator.js
代码: [核心逻辑]
验证: npm test --grep "basic format"
时间: 4分钟
Commit: "feat: Add basic email format validation"

...共15个任务

# 第3步:执行计划
/superpowers:execute-plan

Claude:
启动子agent执行任务1...
✅ 测试框架创建完成
🔍 审查1:符合规范? ✅ 通过
🔍 审查2:代码质量? ⚠️ 发现1个警告
   - 建议:添加注释说明测试策略
📝 已修复并提交

启动子agent执行任务2...
✅ 基本验证实现完成
🔍 审查1:符合规范? ✅ 通过
🔍 审查2:代码质量? ✅ 完美

...继续执行15个任务

# 第4步:收尾
所有任务完成,测试覆盖率98%
选择操作:
1. Merge到主分支
2. 创建PR
3. 继续开发
4. 丢弃更改

结果:

• • 耗时:45分钟(含设计讨论)
• • 质量:98%测试覆盖率
• • Bug:0个
• • 代码重写次数:0次

四、技术亮点:不只是提示词

🔍 技能自动触发

Claude启动时看到:
<session-start-hook>
你拥有Superpowers!
立即阅读:~/.claude/plugins/cache/Superpowers/skills/getting-started/SKILL.md
</session-start-hook>

Claude学到:
✅ 你有skills
✅ 搜索skills:运行脚本
✅ 使用skills:读取并遵守
✅ 必须用skill,不是可选

关键:强制加载,不是建议

🧠 递归学习能力

# 场景:给Claude一本编程书
你:"读这本《设计模式》,提取可复用技能"

Claude:
1. 读完整本书
2. 识别可复用模式
3. 写成新skill文档
4. 测试是否有效
5. 添加到技能库

# 你现在有了设计模式技能!

这是foundational idea:Claude教Claude

📂 双层技能系统

核心技能(Core Skills):
位置:插件仓库
内容:TDD、系统调试、结构化规划
维护:社区共同维护

个人技能(Personal Skills):
位置:~/.config/superpowers/skills/
内容:你的领域专属技能
优先级:覆盖核心技能

shadowing机制:个人技能优先!

🔧 三个斜杠命令

/superpowers:brainstorm
# 交互式设计优化
# 苏格拉底式提问
# 分块展示设计

/superpowers:write-plan
# 创建实施计划
# 2-5分钟小任务
# 完整代码+验证步骤

/superpowers:execute-plan
# 批量执行计划
# 人工检查点
# 子代理驱动可选

五、社区数据:真实反馈

📊 GitHub数据

• • Stars: 12.3K(爆炸增长)
• • Forks: 997(大量实际使用)
• • Contributors: 12位
• • Issues: 26个(质量高,反馈积极)
• • 许可证: MIT开源

💬 用户评价

来自betazeta.dev的技术博客:

“Superpowers把Claude Code从智能自动补全变成了结构化协作者。它强制执行最佳实践,确保质量内置,卸下了流程管理的认知负担。”

来自trevorlasn.com的开发者:

“这个插件拯救了我的生产环境。以前Claude会跳过文件导致bug,现在它被迫验证所有文件,一个都不能漏!”

来自Medium的Yee Fei:

“工作流变得真正令人愉悦。每个任务都是原子单元,每次代码审查都是质量门槛,问题立即被捕获,防止技术债务。”

六、支持的平台

Claude Code(推荐)

# 通过插件市场安装
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# 重启后自动加载
# 看到:/superpowers:brainstorm等命令

Codex

告诉Codex:
"获取并遵循这个URL的指令:
https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md"

OpenCode

告诉OpenCode:
"获取并遵循这个URL的指令:
https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md"

七、Superpowers哲学

核心原则

1. 测试驱动开发(TDD)

先写测试,永远如此
不是建议,是命令

2. 系统化胜过临时

流程优于猜测
有方法论就用方法论

3. 降低复杂度

简单是首要目标
YAGNI(You Aren't Gonna Need It)

4. 证据胜过声称

验证后再声称成功
"我觉得修好了"不算数

八、对比分析

九、立即开始

快速体验(3步)

# 1. 在Claude Code中安装(2分钟)
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# 2. 重启Claude Code

# 3. 开始使用!
/superpowers:brainstorm
# 描述你要做的功能...

完整工作流

# 场景:构建用户认证系统

# Step 1:头脑风暴
/superpowers:brainstorm
# Claude开始问问题:
# - JWT还是Session?
# - 需要OAuth吗?
# - 密码复杂度要求?
# - 速率限制?

# Step 2:审查设计
# Claude分块展示设计,逐段确认

# Step 3:写计划
/superpowers:write-plan
# 生成implementation-plan.md
# 30个任务,每个2-5分钟

# Step 4:执行
/superpowers:execute-plan
# 选择:当前会话 or 独立子agent
# 自动执行+双重审查

# Step 5:完成
# 测试通过,选择merge策略

写在最后

Superpowers的三大革命

1. 从建议到强制

• • 不再是”Claude你应该…”
• • 而是”Claude你必须…”
• • 工程纪律代码化

2. 从单体到微服务

• • 不再是一个agent干所有事
• • 而是每个任务独立子agent
• • CI/CD思想应用于AI

3. 从工具到方法论

• • 不再只是写代码快
• • 而是整个开发流程优化
• • 从初级工程师到资深架构师

核心价值

✅ 质量保证 – TDD+双重审查+系统调试
✅ 可预测性 – 严格流程,避免意外
✅ 可扩展性 – 递归学习,持续进化
✅ 零学习成本 – 自动触发,强制执行

🔗 相关链接

• • GitHub仓库: https://github.com/obra/superpowers
• • 作者博客: https://blog.fsck.com/2025/10/09/superpowers/
• • 插件市场: https://github.com/obra/superpowers-marketplace
• • 实验技能: https://github.com/obra/superpowers-lab