🤖 Superpowers — AI 编程技能框架
GitHub:
obra/superpowers
"AI 编程代理的完整方法论" — 让 AI 代理遵循系统化开发流程，而不是一上来就写代码。
核心理念
Superpowers 不是简单给 AI 装几个提示词，而是构建了一整套开发工作流，强制 AI 在每个关键节点停下来做正确的事：
原则 | 说明 |
|---|---|
系统化 > 随意发挥 | 有明确的流程，不是想到哪写到哪 |
先设计后实现 | AI 不会一上来就写代码，而是先通过提问厘清需求 |
小任务驱动 | 每个任务 2-5 分钟，精确到文件路径和验证步骤 |
TDD 红绿重构 | 必须先写失败的测试，再写代码，再重构 |
双阶段评审 | 每段代码先检查是否符合规范，再检查代码质量 |
自动化触发 | 技能自动激活，无需人工干预 |
7 步核心工作流
① 头脑风暴 (brainstorming)
↓
② Git Worktree 创建隔离工作区
↓
③ 编写计划 (writing-plans)
↓
④ 执行计划 (executing-plans / subagent-driven-development)
↓
⑤ 测试驱动开发 (test-driven-development)
↓
⑥ 代码评审 (requesting-code-review)
↓
⑦ 完成开发分支 (finishing-a-development-branch)
每一步详解
① 头脑风暴 — AI 通过苏格拉底式提问深化你的粗糙想法，呈现分段设计文档供你审核确认
② Git Worktree — 在新分支上创建隔离工作区，运行项目初始化，验证干净的测试基线
③ 编写计划 — 将设计拆解为 2-5 分钟的小任务，每任务含精确文件路径、完整代码和验证步骤
④ 子代理驱动开发 — 每个任务分配独立子代理，强制两阶段审查（规范合规性 → 代码质量）
⑤ TDD 红绿重构 — 写失败测试 → 看它失败 → 写最小代码 → 看它通过 → 重构 → 提交
⑥ 代码评审 — 对照计划审查实现，按严重级别报告问题，critical 问题阻断进度
⑦ 完成分支 — 验证全部测试通过，提供 merge/PR/keep/discard 选项，自动清理 worktree
技能库（Skills Library）
类别 | 技能名称 | 功能 |
|---|---|---|
🧪 测试 | test-driven-development | 红绿重构循环（含测试反模式参考） |
🐛 调试 | systematic-debugging | 四阶段根因分析（根因追踪、纵深防御、条件等待） |
🐛 调试 | verification-before-completion | 确保 Bug 真正修复 |
💡 协作 | brainstorming | 苏格拉底式设计细化 |
💡 协作 | writing-plans | 输出详细实施计划 |
💡 协作 | executing-plans | 批量执行与人工检查点 |
💡 协作 | dispatching-parallel-agents | 并发子代理工作流 |
💡 协作 | requesting-code-review | 评审前检查清单 |
💡 协作 | receiving-code-review | 响应评审反馈 |
💡 协作 | using-git-worktrees | 并行开发分支管理 |
类别 | 技能名称 | 功能 |
|---|---|---|
💡 协作 | finishing-a-development-branch | Merge/PR 决策工作流 |
💡 协作 | subagent-driven-development | 快速迭代两阶段审查 |
📝 Meta | writing-skills | 创建新技能的最佳实践 |
📝 Meta | using-superpowers | 技能系统入门指南 |
安装方法
Claude Code（官方插件市场）✅ 推荐 /plugin install superpowers@claude-plugins-official Claude Code（Superpowers 市场） /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace Cursor /add-plugin superpowers 或直接在插件市场搜索 "superpowers" OpenAI Codex CLI /plugins # 搜索 superpowers，选择 Install Plugin GitHub Copilot CLI copilot plugin marketplace add obra/superpowers-marketplace copilot plugin install superpowers@superpowers-marketplace Gemini CLI gemini extensions install https://github.com/obra/superpowers gemini extensions update superpowers # 更新适用场景
场景 | 为什么用 Superpowers |
|---|---|
🎯 复杂系统开发 | AI 不会一头扎进代码，能先做架构设计 |
👥 团队协作 | 强制评审和文档，减少 AI 生成的"幻觉代码" |
🔄 长期项目维护 | 子代理可独立工作 1-2 小时不偏离计划 |
🧪 TDD 实践 | 强制先写测试，避免 AI 直接生成实现代码 |
🐛 Bug 修复 | 系统化调试流程（4 阶段根因分析） |
📚 工程知识积累 | 技能库可不断扩展，团队规范可沉淀 |
哲学信条
TDD — 测试先行，永远
系统化 > 临时发挥 — 流程优于猜测
复杂度削减 — 简洁是终极目标
证据 > 断言 — 验证后再宣布完成
作者: Jesse Vincent (GitHub: @obra) | 社区:
Discord
许可证: MIT | 开源: 是
