Superpowers 是一个开源的代理技能（agentic skills）框架，专为编码代理（coding agents）设计，提供一套可组合的技能库和软件开发方法论，帮助 AI 代理实现高效、可扩展的工作流。该框架的核心在于通过 Markdown 格式的 “技能文件”（SKILL.md）来定义模块化行为，这些技能可以自动触发，支持沙箱环境（git worktrees）、子代理驱动开发（subagent-driven-development）和严格的测试驱动开发（TDD），从而解决传统 AI 代理在复杂项目中易偏离轨道的问题。
核心概念与模块化设计
Superpowers 的设计哲学强调 “系统化而非临时拼凑”（systematic over ad-hoc）、TDD 优先、复杂度最小化和证据优先验证。代理不是直接跳入编码，而是先通过技能检查器（skill checker）扫描上下文，自动加载相关技能。例如，当用户提出 “帮我实现一个功能” 时，代理会触发 brainstorming 技能，进行苏格拉底式对话，逐步提炼需求并输出可读的设计文档，分块呈现以便用户审核。
技能库分为测试、调试、协作和元技能四大类：
- 测试技能：
test-driven-development，强制 RED-GREEN-REFACTOR 循环：先写失败测试、验证失败、再写最小代码通过测试、最后重构。禁止在测试前写代码。 - 调试技能：
systematic-debugging，4 阶段根因分析，包括根因追踪、防深度防御和条件等待。 - 协作技能：
writing-plans将任务拆成 2-5 分钟粒度的子任务，每任务指定精确文件路径、完整代码和验证步骤；subagent-driven-development为每个任务派生子代理，进行两阶段审查（规格合规 → 代码质量）。 - 沙箱与工具集成：
using-git-worktrees自动创建隔离分支工作树，支持并行开发，避免冲突；集成 git、测试工具等 shell 命令。
这些技能通过 shell 脚本动态加载（如在 Claude Code 中通过 plugin），实现工具集成和代理组合。作者 obra 强调，技能是 “强制工作流，而非建议”，代理必须使用匹配技能，否则视为违规。
详细工作流与可落地参数
Superpowers 的基本工作流如下，提供具体参数配置：
-
Brainstorming（需求 brainstorm）：
- 触发条件：检测到 “build/plan/feature” 等关键词。
- 参数：设计文档分块大小 ≤ 200 字 / 块；用户签字阈值：100% 同意后推进。
- 清单：代理提问 “核心目标？”“备选方案？”“权衡 YAGNI vs 扩展性？”。
-
Git Worktree 创建：
- 触发：设计批准后。
- 参数：分支名
${project}-${timestamp}；验证基线：git status clean && tests pass。 - 沙箱隔离：每个任务独立 worktree，超时 30min 自动清理。
-
计划编写（writing-plans）：
- 参数：任务粒度 2-5 分钟（~50-100 行代码）；每任务格式：文件路径 + 预期代码 + 验证命令（如
npm test）。 - 强调：假设执行者 “资浅工程师、无上下文、厌恶测试”，计划须自包含。
- 参数：任务粒度 2-5 分钟（~50-100 行代码）；每任务格式：文件路径 + 预期代码 + 验证命令（如
-
执行阶段：
- 选项 1：
subagent-driven-development– 逐任务派生子代理，审查阈值：Critical 问题阻塞（>1 立即修复），Major 累计 >3 回滚。 - 选项 2：
executing-plans– 批量执行，人间检查点每 5 任务。 - TDD 参数：测试覆盖 >90%；失败重试 ≤3 次。
- 选项 1：
-
审查与完成（requesting-code-review & finishing-a-development-branch）：
- 审查：分级（Critical/High/Medium/Low），Critical 阻塞。
- 完成选项：PR/Merge/Discard；清理：
git worktree remove。
监控要点：
- 日志追踪：技能触发日志
~/.claude/plugins/cache/Superpowers/logs/，监控触发率 >95%。 - 性能阈值：单任务耗时 <10min；偏离率（无技能执行）<5%。
- 回滚策略：若代理忽略技能，注入
using-superpowers元技能重置会话。
安装与配置指南
安装视平台而定，优先 Claude Code/Cursor：
- Claude Code：
/plugin marketplace add obra/superpowers-marketplace→/plugin install superpowers@superpowers-marketplace→ 重启。 - Cursor：市场直接安装。
- Codex/OpenCode：代理执行
Fetch https://raw.githubusercontent.com/obra/superpowers/main/.codex/INSTALL.md。
验证：新会话问 “计划这个功能”，应自动触发技能。自定义技能：用 writing-skills 模板创建 SKILL.md，测试于子代理场景（如时间压力、沉没成本测试）。
优势、局限与扩展
优势：模块化提升代理自主性 2-3 倍（博客中 Claude 可自主 2 小时）；沙箱防污染；说服原理（如权威、稀缺）确保遵守。 局限：依赖平台 plugin；技能学习曲线（需理解 Markdown 规范）；非通用（偏 coding agents）。
扩展清单：
- 集成记忆系统：向量索引过去对话，检索相关技能。
- 分享机制：GitHub PR 新技能。
- 压力测试：模拟生产场景验证技能鲁棒性。
Superpowers 代表 agentic AI 向工程化转型的关键一步，通过标准化技能实现可复用 “超能力”。
资料来源：
（正文字数：约 1250 字）