🚀 告别上下文爆炸！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 通过全新上下文 + 两阶段审查从根源上规避了上下文污染问题：

1. 上下文隔离与职责分离：每个子智能体从全新上下文启动，专注编码；另有审查子智能体专职质量检查。
2. 两阶段严格审查（工程化核心设计）：
   • 规范合规审查 (Spec Review)：功能是否做全？边界条件是否覆盖？（不关注代码风格）。
   • 代码质量审查 (Code Quality Review)：是否符合 DRY 原则？命名是否规范？拒绝过度工程化。
3. 自动重试与并行：审查未通过则自动创建新子智能体重做，相互独立的任务可并行处理。

💡 两种执行模式怎么选？

建议：需求明确用子智能体驱动，探索性开发用计划执行。

🛠️ 三、 标准化 AI 编程工作流

Superpowers 定义了覆盖全生命周期的标准化流程，全程通过 Git 管理产出：

1. 🧠 Brainstorming (头脑风暴)：AI 连续提问澄清需求，生成分段展示的 design.md，人工确认后继续。
2. 🌿 Git Worktree (环境隔离)：创建独立开发环境，避免频繁 checkout，多功能并行开发不影响主工作区。
3. 📝 Writing Plans (任务拆解)：将大功能拆解为 2-5 分钟的原子化小任务，包含明确测试步骤。
4. 🤖 Subagent Development (子智能体开发)：为每个小任务启动独立子智能体，自动触发两阶段审查。
5. 🧪 TDD (测试驱动开发)：严格按 RED-GREEN-REFACTOR 循环实现功能。
6. 🔍 Code Review (代码审查)：全量质量检查，确保符合工程规范。
7. 🏁 Finish Branch (完成)：收尾开发分支。

⌨️ 四、 常用技能与触发指令大全

这是插件最强大的部分，掌握这些技能指令，你就能精准指挥 AI：

1. 高频核心技能速查

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 清理残留记录。

🎯 结语

Superpowers 让 AI 从「单纯的代码生成助手」，真正蜕变为「融入工程化流程的协作伙伴」。它将重复、易出错的环节自动化，让开发者可以重新聚焦于架构设计与业务创新。

🔗 GitHub 官方资源：obra/superpowers