第 25 章 · 三大技能仓库对比
本章目标：把 mattpocock/skills、obra/superpowers、Fission-AI/OpenSpec 三个仓库并列对照，理解它们各自的工程哲学与适用场景，能在实际项目中做出选型判断。
25.1 三个仓库的定位差异
| 维度 | mattpocock/skills | obra/superpowers | Fission-AI/OpenSpec |
|---|---|---|---|
| 哲学 | "小而可改，反框架接管" | "技能自动触发，端到端跑通" | "规格即工件，fluid not rigid" |
| 核心主张 | 技能保持小、可替换、可魔改 | 提供完整开发方法论，技能按需激活 | 变更即文档，spec-driven 推动开发 |
| 安装方式 | Claude Code 插件 或 skills.sh | pip install superpowers | @fission-ai/openspec CLI |
| 典型场景 | 给现有项目注入一组高质量技能 | 从零到交付一个功能（含 TDD） | 在 brownfield 项目中推动变更 |
| 与标准关系 | 遵循 Agent Skills 规范 | 遵循规范，技能自动触发 | 独立路线，/opsx 命令流 |
25.2 mattpocock/skills：给工程师的真实技能
理念
Matt Pocock（Total TypeScript 作者）明确反对 GSD、BMAD、Spec-Kit 这类"接管开发流程"的框架：
"Approaches like GSD, BMAD, and Spec-Kit try to help by owning the process. But while doing so, they take away your control and make bugs in the process hard to resolve."
他的方案是：技能保持小、可替换、可魔改。
两种安装哲学
# 方式一：Claude Code 官方插件（订阅制，只读）
claude plugins install mattpocock-skills
# 方式二：skills.sh 复制可编辑副本
npx skills@latest add mattpocock/skills
# 交互式挑选你想要的技能前者适合"用最新稳定版"；后者适合"我要改技能内容适应我的项目"。
选型建议
- ✅ 适合：想要即插即用的高质量技能、不想维护一整套方法论
- ⚠️ 局限：需要你自行决定什么时候、用哪些技能；没有强制流程
25.3 obra/superpowers：端到端方法论
理念
Superpowers 宣称是 "complete software development methodology for your coding agents"。核心卖点：技能自动触发，端到端跑通。
六步工作流
brainstorming → using-git-worktrees → writing-plans
→ subagent-driven-development / executing-plans
→ test-driven-development → requesting-code-review每一步都是一个技能，按序触发：
- Brainstorming：先不写代码，让 agent 通过问答打磨想法，输出设计文档；
- Using Git Worktrees：为每个任务创建隔离的 worktree，主分支保持稳定；
- Writing Plans：把设计拆成 2–5 分钟能完成的子任务，每步带精确文件路径和验证步骤；
- Subagent-Driven Development：每个子任务派一个独立 subagent 执行，经过两阶段审查；
- Test-Driven Development：强制 RED-GREEN-REFACTOR；
- Requesting Code Review：任务间插入 review 环节，阻塞性 bug 阻止下一步。
选型建议
- ✅ 适合：希望"零配置跑通完整开发流程"的团队，有复杂功能需要系统化拆解
- ⚠️ 局限：引入较多约束（worktree/TDD/review），不适合快速原型或探索性实验
25.4 Fission-AI/OpenSpec：规格驱动开发
理念
OpenSpec 的核心哲学："→ fluid not rigid, → iterative not waterfall, → easy not complex"。它不把技能当作重点，而是把"规格"（spec）作为驱动开发的第一公民。
/opsx 命令流
# 探索需求
/opsx:explore "我想给项目加一个暗色主题"
# 提出正式变更
/opsx:propose add-dark-mode
# 应用变更
/opsx:apply add-dark-mode
# 完成后归档
/opsx:archive add-dark-mode每次 propose 会在 openspec/changes/<name>/ 下生成 proposal.md：
# Proposal: Add Dark Mode
## Why
用户反馈夜间使用疲劳，提升可读性。
## What Changes
- 新增 CSS 变量 `--bg-color` / `--text-color`
- 添加系统偏好检测（prefers-color-scheme）
- 提供手动切换按钮
## Impact
- 涉及：src/theme.ts、styles.css
- 不影响：业务逻辑层选型建议
- ✅ 适合：有稳定产品、需要严格变更追踪的大型团队；brownfield 项目改造
- ⚠️ 局限：
/opsx命令依赖特定的 agent 集成；对绿色项目可能显得重
25.5 三者的协同组合
实际工程中，这三个工具往往不是单选而是组合：
[OpenSpec] ← 管"做什么"（规格与决策记录）
↓
[Superpowers] ← 管"怎么做"（完整工作流驱动）
↓
[mattpocock/skills] ← 管"细节优化"（日常编码辅助）一个典型组合场景：
- 用 OpenSpec 发起变更提案，产出
proposal.md； - 用 Superpowers 跑 brainstorm → plan → TDD 的完整循环；
- 在每日编码时，用 mattpocock 的技能做代码审查、commit helper 等日常辅助。
三条路线都尊重 Agent Skills 规范的发现与加载机制，可以共享在同一个 .pi/skills/ 目录中协同工作。
本章小结
- mattpocock/skills：小而可改的技能集合，反框架哲学，两种安装方式
- obra/superpowers：完整开发方法论，技能自动触发，六步工作流涵盖 brainstorm 到 review
- Fission-AI/OpenSpec：规格驱动，
/opsx命令流，变更即工件，专为 brownfield 设计 - 三者不互斥，可按场景组合使用；都遵循 Agent Skills 规范的渐进披露精神
🧪 随堂测验
点击你认为正确的选项。答错时会展示正确答案与原因解析。
1. mattpocock/skills 的两套安装方式的核心理念差异是什么？
2. Superpowers 的六步工作流中，哪一步负责强制 RED-GREEN-REFACTOR？
3. OpenSpec 的核心设计哲学不包括以下哪项？
4. 在 Brownfield 项目中，最适合优先引入的组件是哪个？
🛠️ 动手实践
- 任选 mattpocock/skills 中的一个技能（如
commit-helper），用npx skills@latest add安装到自己的项目，观察触发时机。 - 用
pip install superpowers安装 Superpowers，跑一次 brainstorming 流程，记录输出。 - 在一个已有仓库里运行
/opsx:explore和/opsx:propose，理解 proposal.md 的生成结构。
完成练习后，进入下一章：Loop Engineering：从提示到循环。