作为开发者,你是否在使用 AI 编程时遇到过这些折磨:对话轮次一多,AI 就开始“胡言乱语”(上下文膨胀);AI 写的代码虽然能跑,但毫无规范,最终变成“一次性”的屎山;没有 TDD、没有 Code Review,完全靠人工盯着 AI 修复一个个 Bug……
如果你受够了这些,那么 Superpowers 绝对是你需要的工程级开发利器!它并非单一的技能工具,而是由 20+ 可组合 Skills 构成的系统化工作流插件,能让 Claude Code、Cursor 等 AI 智能体乖乖遵守工程最佳实践。
�️ 一、 核心架构与技能系统
Superpowers 采用高可扩展的四层分层架构,核心抽象单元是 技能(Skills):
- 编写格式:采用 YAML Frontmatter + Markdown 的轻量级格式,简洁易扩展。
- 覆盖机制:支持无侵入式扩展。个人自定义技能(
~/.claude/skills/)优先级大于插件默认技能库。 - 强制指定:可以通过完全限定名(如
superpowers:skill-name)强制使用特定技能。
🌟 二、 核心创新:子智能体驱动开发 (SDD)
随着对话轮次增加,早期决策会持续干扰后续输出。Superpowers 通过全新上下文 + 两阶段审查从根源上规避了上下文污染问题:
- 上下文隔离与职责分离:每个子智能体从全新上下文启动,专注编码;另有审查子智能体专职质量检查。
- 两阶段严格审查(工程化核心设计):
- 规范合规审查 (Spec Review):功能是否做全?边界条件是否覆盖?(不关注代码风格)。
- 代码质量审查 (Code Quality Review):是否符合 DRY 原则?命名是否规范?拒绝过度工程化。
- 自动重试与并行:审查未通过则自动创建新子智能体重做,相互独立的任务可并行处理。
💡 两种执行模式怎么选?
| 对比维度 | 子智能体驱动开发(Subagent-Driven) | 计划执行(Executing Plans) |
|---|---|---|
| 会话模型 | 当前会话内创建子智能体 | 并行独立会话 |
| 任务上下文 | 全新上下文,无干扰 | 批量执行,共享上下文 |
| 审查机制 | 自动两阶段审查,循环重试 | 人工检查点,需手动确认 |
| 适用场景 | 需求明确、测试完整的独立任务 | 探索性开发、需中途调整策略的任务 |
建议:需求明确用子智能体驱动,探索性开发用计划执行。
🛠️ 三、 标准化 AI 编程工作流
Superpowers 定义了覆盖全生命周期的标准化流程,全程通过 Git 管理产出:
- 🧠 Brainstorming (头脑风暴):AI 连续提问澄清需求,生成分段展示的
design.md,人工确认后继续。 - 🌿 Git Worktree (环境隔离):创建独立开发环境,避免频繁
checkout,多功能并行开发不影响主工作区。 - 📝 Writing Plans (任务拆解):将大功能拆解为 2-5 分钟的原子化小任务,包含明确测试步骤。
- 🤖 Subagent Development (子智能体开发):为每个小任务启动独立子智能体,自动触发两阶段审查。
- 🧪 TDD (测试驱动开发):严格按 RED-GREEN-REFACTOR 循环实现功能。
- 🔍 Code Review (代码审查):全量质量检查,确保符合工程规范。
- 🏁 Finish Branch (完成):收尾开发分支。
⌨️ 四、 常用技能与触发指令大全
这是插件最强大的部分,掌握这些技能指令,你就能精准指挥 AI:
1. 高频核心技能速查
| 技能名称 | 核心功能 | 适用场景 |
|---|---|---|
brainstorming |
提问澄清需求,生成标准化设计文档 | 需求模糊、需补充设计时 |
writing-plans |
将大任务拆解为可执行原子化小步骤 | 大功能 / 复杂任务开发启动前 |
subagent-driven-development |
子智能体并行执行任务,自动两阶段审查 | 需求明确、可并行的子任务处理 |
test-driven-development |
按 TDD 红-绿-重构循环实现功能 | 功能实现阶段,追求高代码质量 |
systematic-debugging |
结构化分析 Bug 根因,给出解决方案 | 代码报错、出现异常行为时 |
using-git-worktrees |
创建 Git worktree 隔离开发环境 | 同时开发多个功能,避免环境冲突 |
verification-before-completion |
任务结束前全量验证功能完整性 | 功能完成准备提交时 |
requesting-code-review |
发起标准化代码审查 | 提交代码、合并分支前 |
2. 技能触发规则与话术
- 自动触发:当你的需求描述不明确时,AI 会自动触发
brainstorming技能。 - 手动触发关键词:
- 想用 TDD?对 AI 说:
使用 TDD 方式开发或先写测试。 - 遇到 Bug?对 AI 说:
帮我系统化调试这个报错或代码不工作了。 - 需要做计划?对 AI 说:
帮我制定开发计划。
- 想用 TDD?对 AI 说:
- 组合触发:
“用 TDD 方式实现用户认证,完成后帮我做代码审查”(会自动同时触发test-driven-development和requesting-code-review)。
🚀 五、 极速上手与排坑指南
1. 两步极简安装
在 Claude Code 终端中执行以下命令:
# 1. 添加插件市场源
# 功能:将 superpowers 的官方插件仓库注册到本地环境中
/plugin marketplace add obra/superpowers-marketplace
# 2. 安装插件
# 功能:从配置好的市场源中拉取并安装最新版 superpowers 插件
/plugin install superpowers@superpowers-marketplace
重启 Claude Code 即可生效!
2. 常见问题 (FAQ)
- Q: AI 没触发技能,直接开始写代码怎么办?
- A: 执行
/plugin list确认加载;检查using-superpowers是否激活;尝试直接说“使用 brainstorming 技能”手动触发;或重启会话。
- A: 执行
- Q: 安装插件报错?
- A: 终端执行
rm -rf ~/.cache/superpowers清除缓存,然后加上--force参数强制重新安装。
- A: 终端执行
- Q: 创建 Git Worktree 失败?
- A: 确保 Git 版本 >= 2.5 (
git --version);使用git worktree prune清理残留记录。
- A: 确保 Git 版本 >= 2.5 (
🎯 结语
Superpowers 让 AI 从「单纯的代码生成助手」,真正蜕变为「融入工程化流程的协作伙伴」。它将重复、易出错的环节自动化,让开发者可以重新聚焦于架构设计与业务创新。
🔗 GitHub 官方资源:obra/superpowers












这一切,似未曾拥有