项目概览
obra/superpowers 是面向 AI 编程 Agent 的完整软件开发方法论，由 14 个可组合的 Skill 构成，自动触发、强制执行工程纪律。
- 定位: AI 编程 Agent 的工程纪律框架
- 核心: 7 步工作流（设计→计划→实现→验证）
- 14 个 Skill: Testing、Debugging、Collaboration、Meta 四大类
- 多 Harness 支持: Claude Code、Codex、Cursor、Gemini CLI 等
学习目标
- 理解 Superpowers 核心理念（TDD、系统化、简洁、证据）
- 安装并配置到自己的 Claude Code 环境
- 掌握 7 步核心工作流
- 精通 14 个 Skill 的触发时机和使用方法
- 能在实际项目中应用 subagent-driven-development
学习路径（5 天）
Day 1: 理念与安装
目标: 理解核心理念，完成安装配置
| 任务 | 内容 | 资源 |
|---|---|---|
| 阅读 README | 理解”Agent 不直接跳入写代码”的哲学 | README.md |
| 安装 Superpowers | 在 Claude Code 中安装 | /plugin install superpowers@claude-plugins-official |
| 配置 using-superpowers | 确认 Skill 加载 | 首次对话会触发 |
核心理念:
- TDD 优先 — 永远先写测试
- 系统化 > 临时性 — 流程优于猜测
- 复杂度削减 — 简洁是首要目标
- 证据优于声明 — 声称成功前必须验证
Day 2: 需求分析与设计
目标: 掌握 brainstorming 和 writing-plans
| Skill | 核心要点 |
|---|---|
| brainstorming | Socratic 式需求澄清，输出设计文档，分块展示获取确认 |
| writing-plans | 2-5 分钟粒度任务，含文件路径+完整代码+验证步骤 |
练习: 用 brainstorming 分析一个小型需求，输出一份设计文档
Day 3: 执行与测试
目标: 掌握执行和测试流程
| Skill | 核心要点 |
|---|---|
| using-git-worktrees | 创建隔离 worktree 分支，避免重复创建 |
| subagent-driven-development | 并发子 Agent + 两阶段审查（规格合规→代码质量） |
| test-driven-development | RED-GREEN-REFACTOR 循环，先写失败测试 |
练习: 创建一个新分支，在其中实现一个简单功能，体验 TDD 流程
Day 4: 调试与验证
目标: 掌握系统化调试和问题验证
| Skill | 核心要点 |
|---|---|
| systematic-debugging | 4 阶段根因分析（观察→假设→验证→修复） |
| verification-before-completion | 声称完成前必须验证，证据优于声明 |
练习: 模拟一个 bug，用 systematic-debugging 的 4 阶段流程定位
Day 5: 协作与收尾
目标: 掌握代码审查和分支管理
| Skill | 核心要点 |
|---|---|
| requesting-code-review | 按严重度报告问题，Critical 阻断进度 |
| receiving-code-review | 响应审查反馈，技术验证而非盲从 |
| finishing-a-development-branch | 验证测试，选择 merge/PR/保留/丢弃 |
练习: 完成一个功能后，走一遍 requesting-code-review + finishing 流程
Skill 速查表
| 分类 | Skill | 触发时机 | 核心产出 |
|---|---|---|---|
| 设计 | brainstorming | 写代码前 | 设计文档 |
| 计划 | writing-plans | 有设计后 | 任务清单 |
| 执行 | subagent-driven-development | 有计划后 | 实现代码 |
| 测试 | test-driven-development | 实现中 | 通过的测试 |
| 调试 | systematic-debugging | 遇到 bug 时 | 根因分析 |
| 验证 | verification-before-completion | 声称完成后 | 验证证据 |
| 审查 | requesting-code-review | 任务间 | 审查报告 |
| 收尾 | finishing-a-development-branch | 任务完成 | Merge/PR/保留/丢弃决策 |
关键机制详解
Skill 强制触发
using-superpowers 在每次对话开始时加载，要求 Agent 在任何响应之前先检查是否有适用的 Skill。
两阶段代码审查
subagent-driven-development 对每个任务执行两轮审查：
- 规格合规性
- 代码质量
Worktree 隔离
检测是否已在 linked worktree 中（GIT_DIR != GIT_COMMON），避免重复创建。
相关 Wiki 页面
- agentara-skills — 另一个 Claude Code Skill 扩展库
- agent-skills__tech-leads-club — 安全验证的 Skill 注册表
- agent-skill-loading — Skill 加载机制详解
- agent-harness-anatomy — Agent Harness 组件解剖
下一步
学完本计划后，可以进一步探索：
- 阅读
skills/writing-skills/SKILL.md学习创建自定义 Skill - 阅读
skills/dispatching-parallel-agents学习并发子 Agent 编排 - 参与 Discord 社区讨论