Appearance
Superpowers：给AI编程代理装上完整工程技能库
168k Star！给 AI 编程助手装一套「超级技能」，从此写代码不再瞎搞。它不会帮你写更多代码，但能让写出来的代码质量更高、流程更规范。
一、项目简介
Star：168k | 语言：Shell + JS | 协议：MIT
作者：Jesse Vincent（obra）和 Prime Radiant 团队
开源地址：github.com/obra/superpowers
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 优先 | 先写测试再写代码 |
| 系统化调试 | 不靠猜，按流程排错 |
| 简化复杂性 | 能简单就不复杂 |
| 证据优于声明 | 做完要验证，不能嘴上说成功 |
四、在 Trae 中安装
方法一：手动安装（推荐）
Step 1：克隆仓库
bash
git clone https://github.com/obra/superpowers.gitStep 2：创建 skills 目录
bash
# 国际版 Trae
mkdir -p .trae/skills
# 国内版 Trae CN
mkdir -p .trae-cn/skillsStep 3：复制 skill 文件
bash
# 国际版
cp -r superpowers/.claude/* .trae/skills/
# 国内版
cp -r superpowers/.claude/* .trae-cn/skills/Step 4：重启 Trae
关闭再打开，让它重新扫描 skills 目录。
Step 5：验证
你有 superpowers 吗？方法二：用 OpenSkills 工具
bash
# 1. 全局安装
npm i -g openskills
# 2. 安装 superpowers
openskills install obra/superpowers
# 3. 同步到 AGENTS.md
openskills sync五、安装后的变化
| 变化 | 说明 |
|---|---|
| 主动提问 | brainstorming 技能让 AI 先问清楚需求 |
| 自动拆分任务 | 大需求拆成 2-5 分钟小任务 |
| 先写测试 | TDD 流程强制执行 |
| Bug 排查有章法 | 系统化调试流程 |
手动指定技能
用 brainstorming 技能帮我梳理一下这个需求
用 test-driven-development 的方式实现用户登录功能
用 systematic-debugging 的方法排查这个 Bug六、适用场景
| 人群 | 为什么需要 |
|---|---|
| AI 编程重度用户 | 让 AI 更靠谱，减少返工 |
| 团队协作场景 | 统一代码风格和审查标准 |
| 学习 TDD 的开发者 | AI 手把手带你走流程 |
| 项目管理混乱的团队 | 强制规范开发流程 |
七、注意事项
- Trae 扫描的是直接子目录，skills 下不能再套太多层级
- Trae CN 和国际版目录不同：国内版用
.trae-cn/，国际版用.trae/ - 不是所有技能都适合每次开启，小修小补不需要完整流程
- 定期
git pull同步最新版
总结
| 核心价值 | 说明 |
|---|---|
| 工程大脑 | 让 AI 遵循正确流程 |
| 7阶段工作流 | 从需求到完成自动触发 |
| 四大原则 | TDD + 系统调试 + 简化 + 验证 |
对于用 Trae / Claude Code / Cursor 这些工具写代码的同学，这套技能基本是必装的。
关键词：Superpowers, AI编码代理, TDD, brainstorming, systematic-debugging, Jesse Vincent
