🚀 告别上下文爆炸！Superpowers：为 Claude Code 注入工程级 AI 编程超能力

一言准备中...

作为开发者，你是否在使用 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 方式实现用户认证，完成后帮我做代码审查”（会自动同时触发 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 技能”手动触发；或重启会话。
Q: 安装插件报错？
- A: 终端执行 rm -rf ~/.cache/superpowers 清除缓存，然后加上 --force 参数强制重新安装。
Q: 创建 Git Worktree 失败？
- A: 确保 Git 版本 >= 2.5 (git --version)；使用 git worktree prune 清理残留记录。