Superpowers
自动发现适用技能并落实工程纪律。适合需求明确、规模小到中等、希望 AI 稳妥推进的日常开发。
一、结论
Superpowers 更像“自动挡工程流程”，mattpocock/skills 更像“手动挡工程工作台”。
- 需求明确、规模小到中等、希望 AI 自动落实工程纪律时，优先使用 Superpowers。
- 需求模糊、任务复杂、需要跨会话拆解、多人或多智能体协作及完整决策留痕时，优先使用 mattpocock/skills。
- 两套技能可以同时安装，但一次任务应明确一套主流程，避免重复访谈、重复规划和重复评审。
- 选定主流程后，可以按需借用另一套中的单点技能。
二、目标与范围
目标
- 说明两套技能包的核心差异；
- 建立按任务类型选择技能包的规则；
- 约束两套技能共存时的流程冲突；
- 提供可直接复用的任务入口表达。
不在范围内
- 不以 GitHub Star 或外部文章观点作为事实依据；
- 不替代项目自身的
AGENTS.md、测试门禁及 Git 操作规则； - 不要求所有微小任务都启动完整 SPEC、Ticket 和评审链路。
三、两套技能包的定位
Superpowers：主动介入
通过
brainstorming、writing-plans、systematic-debugging、TDD、代码评审与完成前验证，把工程纪律自动带入任务。
Matt：显式路由
通过
grill-with-docs、to-spec、to-tickets、implement 和 code-review，让使用者掌控每个阶段。
Matt 主流程
grill-with-docs
-> 必要时 prototype
-> to-spec
-> to-tickets
-> 每个 Ticket 独立 implement
-> code-review四、核心差异对比
| 对比项 | Superpowers | mattpocock/skills |
|---|---|---|
| 核心定位 | 自动套用软件工程纪律 | 用户显式选择技能和阶段 |
| 工作模式 | 偏自动，技能主动介入 | 偏手动，关键流程主动调用 |
| 使用感受 | 省心、规范，但可能偏重 | 控制感强，但需要判断路线 |
| 需求澄清 | brainstorming | grill-me / grill-with-docs |
| 计划拆解 | writing-plans | to-spec + to-tickets |
| 超大任务探索 | 先设计再计划 | wayfinder 决策地图 |
| 实施组织 | 当前会话、计划执行或子智能体分工 | 每个 Ticket 独立实施，强调干净上下文 |
| 调试 | systematic-debugging | diagnosing-bugs |
| 评审 | 发起评审、处理反馈、完成前验证 | 依据 Spec 与 Standards 双轴审查 |
| 主要留痕 | 设计与实施计划 | CONTEXT、ADR、SPEC、Tickets、交接文档 |
| 最适合 | 边界明确的日常开发 | 复杂、长期、多会话、多角色任务 |
五、场景选型
优先使用 Superpowers
- 修改边界清楚的功能；
- 修复普通、可稳定复现的 Bug；
- 增加接口、页面、配置项或测试；
- 希望自动执行调试、TDD、评审和验证；
- 任务能在一个会话或少量子任务内完成。
示例入口使用 Superpowers 流程修复订单页面重复提交问题，补充回归测试，并在完成前给出验证证据。
优先使用 mattpocock/skills
- 需求模糊，需要逐项追问和拍板；
- 新项目、复杂功能或跨模块改造；
- 需要跨多个会话或多个智能体实施；
- 需要 ADR、SPEC、Ticket 和交接记录；
- 希望自己明确控制每个阶段。
示例入口使用 mattpocock/skills。先用 grill-with-docs 明确需求和决策，再生成 Spec 与 Tickets；没有确认前不要实施。
不需要完整链路
错别字、单一配置值、只读事实查询、一次日志查看或极小格式调整，只需调用必要技能并执行与风险相称的验证，无需机械生成完整 SPEC、Ticket 和多轮评审材料。
六、快速决策表
| 当前情况 | 推荐选择 | 推荐入口 |
|---|---|---|
| 需求明确、规模小到中等 | Superpowers | 直接说明任务和验收条件 |
| 需求模糊，需要追问 | Matt | grill-with-docs；无项目目录用 grill-me |
| 普通可复现 Bug | Superpowers | systematic-debugging |
| 顽固、间歇性、难复现 Bug | Matt | diagnosing-bugs |
| 大型新项目，路线尚不清楚 | Matt | wayfinder |
| 跨多个会话实施 | Matt | to-spec → to-tickets → implement |
| 已有明确 Spec 的改动审查 | Matt | code-review |
| 跨工具、跨目录或交接 | Matt | handoff |
| 设计问题必须运行后判断 | Matt | prototype |
| 希望 AI 自动落实工程纪律 | Superpowers | 让技能自动路由 |
七、共存与防冲突规则
- 一次任务只设一套主流程：开头明确“这次以 Superpowers 为主”或“这次以 Matt 为主”。
- 允许借用单点能力：可以借用调试、原型或完成前验证，但不要重新启动另一条完整生命周期。
- 用户和项目规则优先：技能不能覆盖明确的用户要求、
AGENTS.md、测试门禁、Git 权限和安全约束。 - 不自动扩大权限：实施完成不代表获得提交、推送、部署或外部发布权限。
- Matt 首次使用先配置：运行
setup-matt-pocock-skills，明确 Issue Tracker、标签、文档位置和项目规则。
八、推荐默认策略
- 日常明确开发任务：使用 Superpowers；
- 复杂需求、架构设计、多会话交付：切换到 mattpocock/skills；
- 极小任务：不启动完整主流程，只使用必要技能并完成最小验证；
- 任务类型变化时：在阶段边界重新选型；
- 不确定选哪个时：使用 Matt 的
ask-matt路由，但暂不实施。
要省心和自动纪律，选 Superpowers；要控制感、复杂拆解与长期留痕，选 mattpocock/skills。
九、来源与证据
- Superpowers 总控规则：
/Users/liang/.codex/skills/using-superpowers/SKILL.md - Superpowers 核心技能目录：
/Users/liang/.codex/skills/ - Matt 技能路由：
/Users/liang/.agents/skills/ask-matt/SKILL.md - Matt 阶段边界：
/Users/liang/.agents/skills/ask-matt/PHASE-BOUNDARIES.md - CLI 来源核验：
npx skills@latest list -g --json
证据等级：A 级为本机实际目录、当前技能说明和 CLI 安装清单；外部文章中的个人体验仅作背景，不作为安装状态或工作流事实依据。
十、验收与人工评审
文档一致性Markdown / HTML 同名同目录
证据原则不依赖未经核实的热度数据
人工状态待确认默认策略是否符合团队习惯
评审检查项
- 定位、对比、适用场景和选型规则是否完整；
- 用户指令、项目规则和 Git 权限是否被明确置于技能默认行为之上；
- 是否可以直接作为后续任务的技能入口；
- 收到反馈后，Markdown 与 HTML 是否同步更新。
已认可经验：暂无，等待评审。
已否定反模式：暂无，等待评审。