AI编程终于告别“写得快但改得疯”！Superpowers插件完整上手指南，把Claude Code变成你的专业工程团队

有没有发现你用AI写代码的时候经常踩这个坑：上来就丢给AI一个需求，AI哗哗半小时给你写出几百行代码，一跑确实能实现功能，等你要加新功能、改bug的时候才发现，代码写得乱七八糟，没有注释、没有规范、逻辑跳脱，改起来比自己从零写还费劲？

说白了就是大家用AI编程的时候总想着“AI万能”，直接跳过了需求确认、架构设计、代码审查这些传统开发里的必备流程，结果AI生成的代码就是“一次性玩具”，只能跑不能维护。今天要给大家介绍的开源插件Superpowers，就是专门解决这个问题的——它给AI编程套上了完整的工程化流程，把TDD、代码审查、架构设计这些最佳实践和AI智能体能力结合，让AI写出来的代码不仅能跑，还符合工业级规范，后期维护省一半力。

一、Superpowers到底是个啥？

简单说，Superpowers就是给你的AI编程助手（Claude Code、Cursor、Codex这些都能用）配备了一套完整的「软件开发工作流手册」。它不是单一的小工具，而是由20+个可自由组合的“技能包”组成的系统化工作流，从需求梳理、架构设计、测试驱动开发，到代码审查、分支管理，整个开发生命周期的所有环节它都给你安排得明明白白。

它的核心逻辑特别简单：不给AI自由发挥的空间，通过预设的技能和初始指令，让AI写代码的时候自动遵循行业最佳实践，从源头上避免“能跑就行”的垃圾代码产生。

它的架构设计有多灵活？

Superpowers采用了分层架构，核心抽象就是「技能（Skills）」，整个架构分成四层，完全做到了平台无关、扩展自由：

1. 用户层：不管你用的是Claude Code还是Cursor，都能直接接入，不绑定特定AI工具
2. 框架层：通过Session Hook机制自动在会话里注入技能上下文，不用你每次手动喊“AI你要遵守规范”
3. 执行层：负责调度子智能体，不同任务隔离执行，还能并行处理多个独立任务
4. 输出层：所有产出的设计文档、代码、测试用例，统一通过Git管理，可追溯可回滚

核心的技能系统怎么玩？

技能是Superpowers最核心的单元，每个技能对应一类开发任务，还定义好了触发条件和执行流程，技能文件用的是YAML Frontmatter + Markdown的轻量格式，普通人也能看懂、能自定义：

---
name: subagent-driven-development
description: "有plan.md文件时自动触发，通过全新子智能体执行任务，自带两阶段审查"
---

# 子智能体驱动开发
## 概述
每个任务用全新的子代理执行，避免上下文污染...
## 执行流程
1. 仅读取一次计划文件
2. 遍历每个任务逐个执行...

最方便的是它支持技能覆盖机制，你自己写的自定义技能优先级比官方默认技能高，你完全可以根据自己团队的编码规范，修改或者新增技能，不用改框架本身的代码：

• 解析优先级：你自己存放在~/.claude/skills/的个人技能 > 官方默认技能库
• 就算重名也不怕，个人技能会自动覆盖官方同名技能，你也可以用superpowers:skill-name的全限定名强制调用官方版本

二、最牛的创新：子智能体驱动开发，彻底解决AI“失忆”问题

用过AI长对话开发的朋友肯定都碰到过「上下文膨胀」的坑：和AI聊开发聊了十几轮之后，AI就开始记不住前面的要求了，前面定好的命名规范后面就违反，前面说好要做的边界处理后面直接忘了，越到后面输出的质量越差。

Superpowers的子智能体驱动开发模式，就是专门解决这个问题的，核心思路就是「全新上下文+两阶段审查」：

• 上下文隔离：每个小任务都派一个全新的子智能体去做，完全不带之前的对话历史，只接收当前任务的描述，根本不会被之前的内容干扰
• 职责分离：专门有实现子智能体负责写代码，还有专门的审查子智能体负责查质量，分工明确不混岗
• 快速重试：要是审查没通过，直接创建新的子智能体重做，不用在原来的对话里反复纠正，越纠越乱
• 并行执行：没有依赖的独立任务可以同时派给多个子智能体一起做，速度直接翻倍

两阶段审查，从根源上避免“审风格忘审功能”

很多人做代码审查的时候经常犯一个错：上来就揪着代码风格、变量命名骂，结果忘了查核心功能是不是完整、边界条件有没有处理。Superpowers直接把审查拆成了两个独立阶段，优先级一目了然：

第一阶段：规范合规审查（先查功能对不对）

核心只问一个问题：这个实现满足需求了吗？
✅ 有没有实现所有要求的功能点
✅ 边界条件有没有处理
✅ 测试用例有没有覆盖所有需求
❌ 完全不关注代码风格、实现细节这些次要问题

第二阶段：代码质量审查（再查代码好不好）

核心问的是：这个代码好维护吗？
✅ 有没有遵循项目的代码风格
✅ 有没有重复代码（符合DRY原则）
✅ 变量、函数命名是不是清晰易懂
✅ 有没有过度工程化的问题

这么拆分之后，完全避免了“代码写得好看但功能缺了一半”的问题，也不会出现“功能没问题但代码乱成麻”的情况，审查意见优先级清晰，不用纠结先改啥后改啥。

两种执行模式怎么选？

Superpowers支持两种任务执行模式，大家可以根据自己的项目情况选：

对比维度	子智能体驱动开发	计划执行模式
会话模型	当前会话内创建子智能体	并行独立会话
任务上下文	每个子智能体用全新上下文	批量执行，共享上下文
审查机制	自动两阶段审查循环	人工设置检查点
执行速度	更快，不需要人工等待	较慢，需要人工确认才能进入下阶段
适用场景	需求明确、边界清晰的独立任务	探索性开发、需要中途调整策略的任务
失败处理	自动创建新子智能体重试	需要人工介入调整

给大家一个简单的选择标准：需求明确、测试用例完整的功能，就用子智能体驱动开发，全程自动化不用管；要是你自己还没想清楚要做啥，需要边做边调整的探索性项目，就用计划执行模式，保留人工决策的节点。

三、完整工作流拆解，跟着走就能写出规范代码

Superpowers定义了一套标准的软件开发全流程，每个阶段都有特定的技能驱动，每个环节都有明确的输出和检查点，就算你是没做过正规开发的小白，跟着流程走也能写出工业级的代码：

我们一个个阶段说清楚每个环节干啥：

阶段1：头脑风暴，先搞清楚要做啥再写代码

和很多鼓励“直接写代码”的AI工具不一样，Superpowers第一步要求必须先澄清需求、做完设计再碰代码。这个阶段AI会像个专业的产品经理一样，通过一系列问题把你的需求抠得明明白白：

AI：“你要做的认证功能需要支持哪些认证方式？”
你：“用户名密码+OAuth”
AI：“OAuth需要支持哪些提供商？”
你：“Google和GitHub”
AI：“Token存在哪里？过期策略是什么？”
…

等所有问题都问完，AI会输出完整的design.md设计文档，还会分成200-300字的小段给你确认，最后提交到Git里留档。别嫌麻烦，这一步把需求弄清楚，后面能少80%的返工，以后新成员进项目，看设计文档就能知道整个功能是怎么回事，不用到处问人。

阶段2：Git Worktree环境隔离，再也不用频繁切分支

传统开发我们切换功能分支都是用git checkout，切一次分支IDE就得重新索引一遍，要是同时开好几个功能，切来切去特别浪费时间。Superpowers用Git Worktree来做环境隔离，每个功能对应一个独立的目录：

# 传统切分支方式，每次切都要改工作区文件，IDE重新索引
git checkout main
git checkout -b feature/auth
# 开发中...
git checkout main # 又要重新索引

# Worktree方式，每个功能一个独立目录，主工作区完全不受影响
git worktree add ../auth-worktree -b feature/auth
cd ../auth-worktree

好处太明显了：不用频繁切分支，不同功能可以同时开发互不干扰，测试实验也不会影响主分支的代码。

阶段3：任务拆解，把大功能拆成2-5分钟就能做完的小步骤

任务拆解的质量直接影响后面AI执行的效果，Superpowers要求把大任务拆成2-5分钟就能做完的小步骤，每个步骤还要有明确的验证标准：

## 任务1：创建User模型和数据库迁移（2分钟）
- 定义User模型（email, password_hash, created_at）
- 创建数据库迁移文件
- 运行迁移验证表结构
验证步骤：
- [ ] 数据库存在users表
- [ ] 表包含所有必填字段

## 任务2：实现密码哈希工具函数（3分钟）
- 用bcrypt实现hash_password()
- 实现verify_password()
- 编写单元测试（正确密码、错误密码、空密码）
验证步骤：
- [ ] 所有测试通过
- [ ] 相同密码生成不同哈希值

拆解的时候记住三个原则：粒度控制在2-5分钟，每个任务有可验证的检查点，尽量减少任务之间的依赖，方便后面并行执行。

四、5分钟快速安装，手把手带你跑通第一个项目

Superpowers安装特别简单，没有复杂的依赖，全程在Claude Code里两步就能搞定：

1. 把插件源加入市场：在终端执行 /plugin marketplace add obra/superpowers-marketplace
2. 安装插件：执行 /plugin install superpowers@superpowers-marketplace
   安装完重启Claude Code就能用了。

我们用开发一个Todo管理应用为例，带你跑通完整流程：

1. 澄清需求：输入命令 /superpowers:brainstorm 我想开发一个简单的网页端Todo管理应用，AI会自动进入需求澄清环节，问清楚你需要的功能，之后会给你2-3个实现方案选，确定方案后生成完整的设计文档，包含架构概览、数据模型、组件结构、状态管理、UI设计、错误处理所有内容。
2. 编写实现计划：设计确认之后，AI会自动把任务拆成小步骤，生成实现计划，你确认之后选择执行模式就行。
3. 执行开发：AI会按照计划逐个执行任务，每个任务完成后自动触发两阶段审查，没通过就自动创建新的子智能体重做，全程不用你管。
4. 验收成果：所有任务完成后，你启动本地测试服务器验证功能就行。
5. 迭代功能：要是后面要加主题切换功能，只要输入 /superpowers:brainstorm 给Todo应用添加主题切换功能，重复上面的流程就行。

五、常用技巧&常见问题排查

常用技能速查表，想用啥直接调

技能名称	功能	使用场景
brainstorming	通过提问澄清需求	需求不明确、需要补充设计的时候
writing-plans	把大任务拆成可执行的小步骤	大功能、复杂任务开始前
executing-plans	按计划执行任务，设置人工检查点	按既定计划推进开发
test-driven-development	执行TDD红-绿-重构循环	功能实现阶段
systematic-debugging	结构化排查Bug根因	出现Bug、功能异常的时候
verification-before-completion	任务结束前做最终验证	功能完成准备提交的时候
requesting-code-review	请求代码审查	提交代码、合并分支前
subagent-driven-development	用子代理执行任务	需要并行处理子任务的时候
using-git-worktrees	用Git Worktree隔离环境	同时开发多个功能的时候

常见触发关键词，不用记命令也能触发

技能	触发关键词
test-driven-development	TDD、测试驱动、先写测试
brainstorming	需求描述不明确的时候自动触发
systematic-debugging	调试、bug、不工作
writing-plans	制定计划、规划

最佳实践建议

• 生产级代码开发就用TDD技能，保障代码质量
• 需求不清晰的时候先调用brainstorming澄清，别着急写代码
• 复杂项目一定要先做任务拆解，再开始实现
• 快速原型、一次性脚本不用走完整流程，Superpowers更适合长期维护的项目
• 技能可以组合用，比如你说「用TDD方式实现用户认证，完成后做代码审查」，就会同时触发两个技能

常见问题排查

1. Claude Code没触发技能直接写代码：先执行/plugin list确认插件已加载，检查using-superpowers技能是否激活，也可以手动触发：「使用brainstorming技能规划这个功能」，还不行就重启会话。
2. 安装Superpowers报错：执行rm -rf ~/.cache/superpowers清除本地缓存，再执行/plugin install superpowers@superpowers-marketplace --force强制重新安装。
3. 创建Git Worktree失败：先检查Git版本，需要2.5以上，执行git worktree prune清理残留的worktree，再手动测试git worktree add ../test-worktree -b test-branch看能不能正常创建。

最后想说

Superpowers这类工具的出现，其实是把AI从「代码生成器」变成了「工程协作伙伴」。之前我们用AI编程，总想着越快越好，结果忽视了软件开发最本质的工程化要求，出来的代码是快了但维护成本极高。而Superpowers通过标准化的流程和技能体系，把那些重复、机械、容易出错的环节都系统化处理了，让我们开发者可以把精力放在真正需要思考的架构设计、业务逻辑和创新上，不用天天给AI补窟窿。

它不是要取代开发者的创造力，而是帮我们把创造力用在更有价值的地方，如果你也受够了AI写的“一次性代码”，下次开发新项目的时候不妨试试Superpowers，说不定能给你带来惊喜。

---

《AI编程从开发到变现小白入门》手册
https://drgphlxsfa.feishu.cn/wiki/LK9pwfT7piXZuhkMHE0cokT3nXd

VicroCode，AI编程时代的代码部署交易平台。支持代码快速在线部署与发布，无需复杂配置，一键上线应用。同时搭建代码交易生态，让开发者的优质代码直接转化为收益，助力个人与企业高效实现技术价值，让每一段代码都能创造商业与实用价值。

网址：[https://www.vicoco.cn](https://www.vicoco.cn)