当你使用AI编程助手（如Trae、Cursor、Opencode）开发项目时，是否遇到过这样的困境：AI一开始表现惊艳，但几轮对话后就容易”跑偏”——丢失上下文、忘记之前的需求、甚至写出与设计不符的代码？

这就是AI编程助手的”上下文衰减”问题。2026年，一个名为Superpowers的开源框架横空出世，短短几个月就在GitHub斩获了149K+星标，被Simon Willison称为”最富有创意的AI编程代理用户之一”。它的核心理念简单却深刻：不是给AI增加功能，而是剥夺AI跳过流程的自由。

今天这篇文章，我会手把手教你从零上手Superpowers，用一个完整的多Agent任务来体验它的7阶段工作流。读完本文，你将掌握如何让AI助手真正成为一个有纪律的专业开发搭档。

一、Superpowers是什么

1.1 背景故事

Superpowers由资深开发者Jesse Vincent（GitHub账号@obra）创建。Jesse有着30年的软件开发经验，他敏锐地发现：AI编程助手最常见的问题不是能力不足，而是缺乏流程约束。

举个例子，当你让Claude帮你开发一个用户登录功能时，AI可能会：

• 直接开始写代码，忽略安全性考虑
• 不写测试用例
• 代码风格前后不一致
• 后期功能偏离最初需求

Superpowers的解决方案是：把30年的软件工程最佳实践，凝练成可组合的”技能”（Skills），让AI在执行任何任务前都必须遵循。

1.2 核心哲学

Superpowers有四条核心原则：

1. 测试优先 (Test-Driven Development) - 先写测试，永远如此2. 系统化优于随意化 (Systematic over ad-hoc) - 流程重于猜测3. 简化复杂度 (Complexity reduction) - 简单是终极目标4. 证据重于声明 (Evidence over claims) - 在宣称成功前先验证

二、环境准备

重要提醒：整个安装过程，你只需要告诉 AI 要做什么，AI 会帮你完成所有操作。你不需要记命令、不需要找菜单，只需要像和助手说话一样描述你的需求。

2.1 OpenCode 安装 Superpowers

第一步：打开 OpenCode

启动 OpenCode，看到主界面后，直接在 AI 对话框里输入：

“帮我安装 Superpowers 技能扩展”

然后等 AI 回应，它会引导你完成剩余步骤。

第二步：等 AI 完成安装

AI 会自动处理安装过程，你只需要确认它的操作即可。

第三步：验证安装成功

新建一个对话，输入：

“列一下我安装的技能”

如果看到 Superpowers 在列表里，说明安装成功了。

2.2 Trae 国内版安装 Superpowers

第一步：打开 Trae

启动 Trae，进入 AI 对话界面。

第二步：告诉 AI 要做什么

在对话框输入：

“帮我安装 superpowers skill”

AI 会自动引导你完成安装流程，你只需要确认它的操作。

第三步：验证安装

安装完成后，新开一个对话，输入：

“查看已安装的技能列表”

看到 Superpowers 就说明成功了。

2.3 Claude Code / Cursor 安装

如果你用的是 Claude Code 或 Cursor，同样的方式：

直接告诉 AI：

“帮我安装 superpowers skill”

AI 会自动处理。

2.4 安装不成功怎么办

如果 AI 说找不到插件：

“搜索一下 Superpowers 怎么安装”

如果安装过程中出错：

“重新安装一下 Superpowers”

如果不确定是否安装成功：

“检查一下 Superpowers 是否已安装”

记住：遇到任何问题，直接告诉 AI，让它帮你解决。这是 vibe coding 的精髓。

三、7阶段工作流详解

Superpowers的核心是一个7阶段的开发工作流，每个阶段对应一个或多个技能（Skill）。

3.1 阶段一：头脑风暴（Brainstorming）

触发时机：在你表达想要构建某个功能时自动激活

核心思想：在写任何代码之前，先通过对话澄清需求

工作方式：AI会问你一系列问题：

• “你想解决什么问题？”
• “有哪些边界情况需要考虑？”
• “技术选型有什么偏好？”

关键约束：

• 不能跳过此阶段直接写代码
• 必须产出设计文档（Design Doc）
• 完成后自动调用writing-plans技能

3.2 阶段二：Git Worktree（使用Git Worktree）

触发时机：设计文档获得批准后

核心思想：创建隔离的开发分支，保护主分支不被污染

工作方式：

1. 在新分支上创建Git Worktree2. 运行项目初始化3. 验证干净的测试基线

3.3 阶段三：制定计划（Writing Plans）

触发时机：有批准的设计文档

核心思想：把工作拆成2-5分钟的微任务，每个任务包含：

• 精确的文件路径
• 完整的代码意图
• 验证步骤

输出示例：

## 任务 1: 创建用户模型- **文件**: `src/models/user.py`- **代码**: 定义User类，包含name, email, password_hash字段- **验证**: 运行 `pytest tests/test_user_model.py`

3.4 阶段四：TDD开发（Test-Driven Development）

触发时机：实现阶段

核心思想：强制执行RED-GREEN-REFACTOR循环

工作流程：

RED:   写一个失败的测试GREEN: 写最少量代码让它通过REFACTOR: 重构代码

Superpowers的硬性规则：在测试存在之前，不允许写任何生产代码。如果写了，框架会自动删除。

3.5 阶段五：子代理驱动开发（Subagent-Driven Development）

触发时机：有实现计划

核心思想：为每个任务派发一个全新的子代理

两阶段审查：

1. 规格符合性审查 - 是否完全按照计划执行？2. 代码质量审查 - 代码是否优雅、可维护？

优势：

• 每个子代理从干净上下文开始，避免上下文膨胀
• 任务可以并行执行
• 审查分离，确保”先做对，再做好”

3.6 阶段六：代码审查（Requesting Code Review）

触发时机：任务之间

核心思想：对照计划进行审查，按严重程度报告问题

严重问题（Critical）：阻塞进度，必须立即修复重要问题（Important）：建议修复次要问题（Minor）：可选优化

3.7 阶段七：分支完成（Finishing a Development Branch）

触发时机：所有任务完成

工作内容：

1. 验证所有测试通过2. 呈现选项：合并/PR/保留/丢弃3. 清理Worktree

四、Superpowers技能库详解

4.1 测试技能

test-driven-development

• RED-GREEN-REFACTOR循环
• 包含测试反模式参考

verification-before-completion

• 确保问题真正被修复
• 不只是表面通过

4.2 调试技能

systematic-debugging

• 4阶段根因分析：
1. 复现问题
2. 隔离变量
3. 定位根因
4. 验证修复

4.3 协作技能

dispatching-parallel-agents

• 并发子代理工作流
• 适用于多模块同时开发

receiving-code-review

• 响应反馈的正确方式
• 区分修复和讨论

4.4 元技能

writing-skills

• 如何创建新的技能
• 遵循最佳实践
• 包含测试方法论

五、进阶技巧

5.1 何时使用Superpowers

适合场景：

• 复杂的多文件功能
• 需要高测试覆盖的生产代码
• 团队协作，期望行为一致

不适合场景：

• 快速修复小bug
• 探索性原型开发
• 单行代码修改

5.2 自定义技能

Superpowers允许你创建自定义技能。技能本质上是Markdown文件，定义触发时机、执行步骤和约束。

<!-- skills/my-custom-skill/SKILL.md --># My Custom Skill## 触发时机Before: [specific trigger condition]## 执行步骤1. Step one2. Step two## 约束- MUST do X- DO NOT do Y until Z## 退出条件Invoking: [next skill to invoke]