Superpowers — 编码 Agent 工程技能插件集详细介绍

一、产品概述

Superpowers 是基于 Agent Skills 开放标准的可插拔编码 Agent 工程技能插件集。作者给它的定位是 「software development methodology for AI coding agents」——把资深工程师平时会坚持的开发方法，封装成 Agent 能自动触发的技能。

它不是独立软件，也不是框架，更不是高级 Prompt 包。它是一组让 AI 在该澄清的时候澄清、该写测试的时候写测试、该调试的时候调试、该评审的时候评审的技能插件。

如果说 SpecKit 管"做什么"，Superpowers 管的就是——“别瞎做，按工程规矩做”。

产品形态速览

维度	说明
产品形态	可插拔的 Agent 技能插件集
所属层级	工程纪律层（工具链第 2 层组成部分）
核心角色	给编码 Agent 补标准化工程能力，约束执行过程
是否可独立运行	否，需加载到支持 Agent Skills 协议的 Agent 中
是否具备编码能力	不具备，只管执行纪律
兼容性	兼容所有支持 Agent Skills 协议的 Agent（Claude Code、Hermes 等）
通俗类比	技术主管——定开发流程、卡质量底线

---

二、安装与配置

2.1 获取 Superpowers

# 拉取技能仓库
git clone https://github.com/agent-skills/superpowers.git

2.2 配置方式一：加载到 Hermes

修改 Hermes 的 config.yaml：

skill_plugins:
  paths:
    - ./superpowers/skills
  enable_skills:
    - tdd-first           # TDD 测试驱动开发
    - code-review-self    # 编码完成自动自评审
    - commit-lint         # Git 提交规范校验

2.3 配置方式二：加载到 Claude Code

如果 Claude Code 支持 Agent Skills 协议，可直接通过配置文件加载技能插件（具体方式取决于 Claude Code 的扩展机制）。

2.4 技能启用策略

策略	做法	适用场景
全量加载	启用全部 14 项技能	企业级交付、强合规项目
按需加载	只选核心技能（如 tdd-first + code-review-self）	中小型项目、个人开发
渐进式	先启用质量保障类，再逐步增加流程规划类和协作规范类	团队从松散到规范的过程

---

三、核心能力详解

3.1 14 项标准化工程技能

覆盖从需求到交付的全流程，核心分为三类：

第一类：流程规划类

技能	作用	解决的问题
设计澄清	编码前先明确需求边界和技术方案	避免"没想清楚就开始写"，减少返工
任务拆解	将大需求拆分为可执行的小任务	避免 Agent 一次处理过多，丢失上下文
计划执行	按拆解后的计划逐步推进	避免跳过关键分析步骤

第二类：质量保障类（最核心）

技能	作用	解决的问题
TDD 测试驱动	强制先写测试用例，再写业务代码	AI 直接写实现跳过测试
系统化调试	按标准流程排查问题，而非随机尝试	调试缺少系统性，修一个 Bug 引入另一个
结果验证	代码写完自动运行测试并验证输出	"看起来能跑"但实际有问题
代码评审	编码完成自动自检逻辑、漏洞、边界	代码能跑但质量不可控

第三类：协作规范类

技能	作用	解决的问题
分支管理	规范 Git 分支创建和合并流程	分支混乱，合代码时冲突不断
提交规范	强制遵循 Angular Commit Convention 等规范	commit message 随意，无法生成 changelog
子任务拆分	将任务拆分为可独立提交的单元	一次提交改十几个文件，难以 review

3.2 自动触发机制（与提示词的本质区别）

Superpowers 的技能是自动触发的，不需要手动调用：

Agent 开始写功能代码
    ↓
TDD 技能自动触发
    ↓
拦截："请先编写测试用例"
    ↓
Agent 写出测试用例并通过
    ↓
放行：允许编写业务代码
    ↓
代码写完
    ↓
code-review-self 自动触发
    ↓
自动检查逻辑漏洞、边界条件、安全问题
    ↓
commit-lint 拦截不规范提交

跳步就会被拉回流程，不用人每次提醒。

3.3 全兼容可插拔

• 兼容所有支持 Agent Skills 协议的 Agent
• 可以全量加载 14 项技能
• 也可以只选单个技能加载
• 不需要改原有开发流程
• 即插即用

---

四、实操 Demo

场景：在用户模块上新增「禁用用户状态」字段

第一步：配置 Superpowers

在 Hermes 配置中启用三个核心技能：

skill_plugins:
  paths:
    - ./superpowers/skills
  enable_skills:
    - tdd-first           # 必须先写测试
    - code-review-self    # 写完自动自评审
    - commit-lint         # 提交必须符合规范

第二步：下发任务

hermes chat "基于现有用户模块，新增禁用用户状态字段"

第三步：Superpowers 强制拦截执行流程

┌─────────────────────────────────────────────┐
│ 步骤 1：TDD 技能触发                        │
│ → 拦截直接写代码                            │
│ → 要求先梳理测试场景                         │
│ → 生成单元测试用例（状态字段默认值、枚举校验等）│
├─────────────────────────────────────────────┤
│ 步骤 2：强制写完测试用例并跑通               │
│ → 才允许进入编码阶段                        │
├─────────────────────────────────────────────┤
│ 步骤 3：code-review-self 自动触发           │
│ → 检查逻辑漏洞                              │
│ → 提示潜在边界问题（如字段回滚、默认值处理）  │
│ → Agent 修复问题后重新评审                   │
├─────────────────────────────────────────────┤
│ 步骤 4：Git 提交                            │
│ → commit-lint 校验 commit 格式              │
│ → 不合规直接拦截提交                         │
│ → 格式：feat(user): add disabled status field│
└─────────────────────────────────────────────┘

---

五、适用场景

✅ 最适合的场景

场景	原因
中小型项目质量兜底	轻量、便宜、无侵入，守住 TDD 和评审底线
个人开发标准化	给单人开发加上工程纪律，不靠自觉
不想上重型规范但要保质量	折中选择——没有 SpecKit 的文档成本，但有执行护栏
小团队协作	统一执行纪律，避免每个人开发方式不同
与 SpecKit 搭配	形成"需求 Spec + 执行 Superpowers"双锁闭环

⚠️ 需要配合其他工具的场景

场景	需要补充什么
多人长期协作	Superpowers 不定义需求标准，需补 SpecKit
强合规交付	需补 SpecKit 做规格事实源 + 审计追溯
团队扩大到 8 人以上	需补 SpecKit 统一需求认知

---

六、与其他工具的关系

6.1 Superpowers vs SpecKit

维度	SpecKit	Superpowers
管什么	需求规格（做什么、做成什么样）	执行纪律（怎么做、按什么流程做）
作用时机	事前——开发前定标准	事中——开发中卡流程
防什么	需求漂移	执行走样
类比	施工图（产品/需求分析师）	监理（技术主管）
能否独立用	需配合编码 Agent	需加载到编码 Agent

为什么经常搭配着用？

• 只上 SpecKit：规格写得再好，Agent 执行时偷工减料、跳测试，质量还是不稳
• 只上 Superpowers：纪律有了，但多人协作没统一需求标准，各理解各的
• 二者搭配：一个定标尺，一个装护栏，一个防需求跑偏，一个防执行走样

6.2 Superpowers vs 系统提示词（Prompt）

这是面试高频追问。为什么不能直接写系统提示词来代替 Superpowers？

维度	系统提示词	Superpowers 技能
稳定性	单次的，长会话中会被稀释	常驻触发，更稳定
标准化	靠人写，团队里每个人质量不一样	标准化封装，统一标准
约束力	更多是"提醒"	可以做流程校验和步骤拦截
类比	口头要求	固化流程制度

---

七、优势与局限总结

优势

优势	说明
轻量无侵入	即插即用，不需要改原有流程
提高质量下限	测试、评审、调试这些动作不再靠模型自觉
灵活可配置	可以全量加载，也可以只启用单个技能
自动触发	不是手动命令，跳步自动被拉回
兼容性好	所有支持 Agent Skills 协议的 Agent 都能用

局限

局限	说明
不能独立运行	必须依赖底层编码 Agent
不定义需求	只约束过程，不定义"做什么"（需配合 SpecKit）
软约束	属于引导式约束，没有 SpecKit 那种硬拦截力度
不适合代替 SpecKit	多人协作仍需 SpecKit 来统一需求标准

一句话总结

Superpowers 是执行流程约束层，前置拦截开发步骤，强制 TDD、代码评审、自测、规范提交。它管的是"开发过程不走样"，和 SpecKit 的"需求不跑偏"互补。提示词像口头要求，技能插件更接近固化的流程制度。