Superpowers 项目介绍

Superpowers 项目介绍

项目定位

Superpowers 是一套面向 AI 编程 Agent 的完整软件开发方法论，通过可组合的 Skill 文档系统，让 Agent 自动遵循纪律化的开发流程——而非依赖 Agent 自行判断该怎么做。

它解决的核心问题：AI Agent 聪明但缺乏纪律，容易跳过设计、测试、审查等关键步骤，导致输出质量不稳定。Superpowers 用 Skill 文档作为”行为代码”，强制 Agent 在正确的时机做正确的事。

核心能力

能力	说明
自动触发 Skill	SessionStart hook 注入 bootstrap，Agent 在每条用户消息后自动检查是否有适用的 Skill
苏格拉底式需求收敛	编码前必须经过 brainstorming：一次一问 → 多方案对比 → 分段审批 → 保存设计文档
子代理驱动开发	按任务分派独立子代理 + 两阶段审核（规格合规 → 代码质量），实现数小时自主开发
TDD 纪律	RED-GREEN-REFACTOR 严格循环，先写代码后补测试 = 删除重写
系统化调试	四阶段根因调查：根因 → 模式 → 假设 → 修复，3+ 修复失败后质疑架构
验证驱动完成	没有运行验证命令 = 不允许声称完成，24 条失败记忆归纳的行为模式

技术栈

• 语言: 纯 Markdown 文档（SKILL.md）+ Bash 脚本（hooks）
• 零依赖: 不依赖任何第三方库或运行时
• 分发: 通过各 Harness 的官方插件市场（Claude Code / Codex / Cursor / Gemini / OpenCode / Copilot CLI / Factory Droid）
• 测试: 子代理压力测试 + 真实 bug 植入验证

架构概览

快速体验

Superpowers 本身是一个零依赖的 Markdown + Bash 插件，安装方式因平台而异：

# Claude Code
/plugin install superpowers@claude-plugins-official

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# Cursor（Agent chat 中）
/add-plugin superpowers

安装后开启新会话，发送 “Let’s make a react todo list”，Agent 应自动触发 brainstorming Skill 而非直接写代码。

教程导读

本教程分为 AI 应用与编程核心两条线索：

AI 应用教程（ai/ 目录）从 Agent 行为的角度切入：

• 01 — Skill 驱动的 Agent 行为编排
• 02 — 子代理驱动开发模式
• 03 — 苏格拉底式需求收敛

编程核心教程（dev/ 目录）从工程实现的角度切入：

• 01 — 零依赖插件架构与多 Harness 适配
• 02 — Git Worktree 隔离工作流
• 03 — 计划编写与分阶段执行
• 04 — TDD 应用于 Skill 文档开发
• 05 — 代码审查的双角色模式
• 06 — 验证驱动的质量门禁