zhaoweiguo 的知识库

obra/superpowers

4分钟阅读

面向 AI 编程 Agent 的完整软件开发方法论，由一组可组合的 Skill 构成，自动触发、强制执行工程纪律。

概述

Superpowers 是 Jesse Vincent（Prime Radiant）开发的 Claude Code / Codex / Cursor / Gemini CLI 等多 Harness 通用插件，当前版本 v5.1.0。

核心理念：Agent 不应直接跳入写代码，而是先通过 Skill 系统强制走完 设计→计划→实现→验证 的完整流程。Skill 自动触发，不需要用户手动调用。

核心工作流（7 步）

步骤Skill触发时机
1brainstorming写代码前，Socratic 式需求澄清，输出设计文档
2using-git-worktrees设计确认后，创建隔离 worktree 分支
3writing-plans有设计文档后，拆分为 2-5 分钟粒度任务，含文件路径+完整代码+验证步骤
4subagent-driven-development / executing-plans有计划后，并发子 Agent 执行或批次执行+人工检查点
5test-driven-development实现过程中，强制 RED-GREEN-REFACTOR，先写失败测试
6requesting-code-review任务间，按严重度报告问题，Critical 阻断进度
7finishing-a-development-branch任务完成后，验证测试，选择 merge/PR/保留/丢弃

Skill 全列表（14 个）

测试

  • test-driven-development — RED-GREEN-REFACTOR 循环，含反模式参考

调试

  • systematic-debugging — 4 阶段根因分析
  • verification-before-completion — 声称完成前必须验证

协作

  • brainstorming — Socratic 设计精炼
  • writing-plans — 详细实现计划
  • executing-plans — 批次执行+检查点
  • dispatching-parallel-agents — 并发子 Agent 工作流
  • requesting-code-review — 代码审查前置清单
  • receiving-code-review — 响应审查反馈
  • using-git-worktrees — 并行开发分支
  • finishing-a-development-branch — Merge/PR 决策工作流
  • subagent-driven-development — 快速迭代+两阶段审查（规格合规→代码质量）

元

  • writing-skills — 创建新 Skill 的最佳实践
  • using-superpowers — Skill 系统入门，每次对话开始时触发

安装方式

# Claude Code（官方 marketplace）
/plugin install superpowers@claude-plugins-official
 
# 或通过 Superpowers marketplace
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
 
# Gemini CLI
gemini extensions install https://github.com/obra/superpowers
 
# Cursor
/add-plugin superpowers

设计哲学

  • TDD 优先 — 永远先写测试
  • 系统化 > 临时性 — 流程优于猜测
  • 复杂度削减 — 简洁是首要目标
  • 证据优于声明 — 声称成功前必须验证

关键机制

Skill 强制触发：using-superpowers 在每次对话开始时加载，要求 Agent 在任何响应（包括澄清问题）之前先检查是否有适用的 Skill。即使只有 1% 的可能性，也必须调用。

两阶段代码审查：subagent-driven-development 对每个任务执行两轮审查——先检查规格合规性，再检查代码质量。

Worktree 隔离：using-git-worktrees 检测是否已在 linked worktree 中（GIT_DIR != GIT_COMMON），避免重复创建；只清理 .worktrees/ 内由 superpowers 创建的 worktree。

多 Harness 支持

Claude Code、Codex CLI、Codex App、Factory Droid、Gemini CLI、OpenCode、Cursor、GitHub Copilot CLI

相关链接

关联页面

关系图谱

反向链接