用 AI 写代码是爽，但你有没有发现——它经常自作主张、一路走到黑？

不问需求就开干，不写测试就说完成了，出了 Bug 靠猜而不是靠排查。说白了，AI 编码代理缺的是一套工程方法论。

GitHub 上有个项目叫 Superpowers，Star 数已经飙到 16.8 万了。它就是来解决这个问题的——给 AI 装上一套完整的软件开发工作流。

---

01 Superpowers：AI 编码代理的「工程技能库」

Star：168k | 语言：Shell + JS | 协议：MIT

作者是 Jesse Vincent（obra）和 Prime Radiant 团队，这帮人专门研究怎么让 AI 编码更靠谱。

Superpowers 说白了就是 一套可组合的「技能框架」，让编码代理（Claude Code、Cursor、Trae 等）在写代码时遵循正确的工程流程。

核心工作流（7 个阶段自动触发）

阶段	技能	干啥的
1	brainstorming	动手前先提问，搞清楚需求
2	using-git-worktrees	用 git worktree 创建隔离开发环境
3	writing-plans	把大任务拆成 2-5 分钟的小块
4	subagent-driven-development	子代理并行干活，两阶段审查
5	test-driven-development	强制 RED-GREEN-REFACTOR 循环
6	requesting-code-review	任务之间自动代码审查
7	finishing-a-development-branch	完成后验证测试并清理

四大原则

• TDD 优先 —— 先写测试再写代码

• 系统化调试 —— 不靠猜，按流程排错

• 简化复杂性 —— 能简单就不复杂

• 证据优于声明 —— 做完要验证，不能嘴上说成功

开源地址：https://github.com/obra/superpowers

---

02 在 Trae 中如何使用？两种方法任选

Trae 已经原生支持 Skills 功能了！下面是具体操作步骤。

方法一：手动安装（推荐，5 分钟搞定）

第 1 步：克隆仓库

git clone https://github.com/obra/superpowers.git

第 2 步：创建 Trae skills 目录

在你的项目根目录下执行：

mkdir -p .trae/skills

⚠️ 注意：如果你用的是 Trae CN（国内版），目录名应该是 .trae-cn/skills。

第 3 步：复制 skill 文件

把 superpowers 仓库中的 .claude/ 目录下的所有技能文件夹复制到 Trae 的 skills 目录：

# 国际版 Trae
cp -r superpowers/.claude/* .trae/skills/

# 或者 Trae CN 版本
cp -r superpowers/.claude/* .trae-cn/skills/

最终目录结构长这样：

你的项目/
├── .trae/              (或 .trae-cn/)
│   └── skills/
│       ├── brainstorming/
│       │   └── SKILL.md
│       ├── test-driven-development/
│       │   └── SKILL.md
│       ├── systematic-debugging/
│       │   └── SKILL.md
│       ├── writing-plans/
│       │   └── SKILL.md
│       └── ...（其他技能文件夹）
├── AGENTS.md           （可选，用于显式激活）
└── 你的源代码...

第 4 步：重启 Trae

关闭再打开 Trae，让它重新扫描 skills 目录。

第 5 步：验证是否生效

在 Trae 的聊天窗口输入：

「你有 superpowers 吗？」

如果安装成功，AI 会回复关于 superpowers 技能的相关内容。

方法二：用 OpenSkills 工具自动安装

# 1. 全局安装 openskills 工具
npm i -g openskills

# 2. 安装 superpowers（自定义仓库）
openskills install obra/superpowers

# 3. 同步到 AGENTS.md
openskills sync

这个方法的好处是可以选择性地安装部分技能，不用全装。

---

03 安装后的实际使用体验

装好之后，你在 Trae 里跟 AI 对话时会发现几个明显变化：

① 它开始主动提问了

之前你一说需求它就直接开写，现在它会先问你几个问题——这是 brainstorming 技能在起作用。

② 自动拆分任务

大需求会被拆成一堆小任务，每个任务 2-5 分钟能完成——这是 writing-plans 和 subagent-driven-development 在工作。

③ 先写测试

写功能代码之前会先写测试用例——TDD 流程强制执行。

④ 出了 Bug 有章法

不再是「我猜可能是 xxx」，而是按照系统化调试流程：复现 → 定位原因 → 修复 → 验证。

手动指定技能

如果想让 AI 使用特定技能，直接在提示词里说就行：

「用 brainstorming 技能帮我梳理一下这个需求」

「用 test-driven-development 的方式实现用户登录功能」

「用 systematic-debugging 的方法排查这个 Bug」

---

04 适用场景 & 注意事项

适合谁用

人群	为什么需要
AI 编程重度用户	让 AI 更靠谱，减少返工
团队协作场景	统一代码风格和审查标准
学习 TDD 的开发者	AI 手把手带你走流程
项目管理混乱的团队	强制规范开发流程

几个注意事项

1. Trae 扫描的是直接子目录 —— skills 下面不能再套太多层级，否则识别不到

2. Trae CN 和国际版目录不同 —— 国内版用 .trae-cn/，国际版用 .trae/

3. 不是所有技能都适合每次开启 —— 比如小修小补不需要跑完整的 brainstorming 流程

4. 版本更新 —— superpowers 更新频繁，建议定期 git pull 同步最新版

一句话总结

Superpowers 就是给 AI 编程代理装上的「工程大脑」。它不会帮你写更多代码，但能让写出来的代码质量更高、流程更规范。

对于用 Trae / Claude Code / Cursor 这些工具写代码的同学来说，这套技能基本是必装的。