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 协议的 AgentClaude Code、Hermes 等通俗类比技术主管——定开发流程、卡质量底线二、安装与配置2.1 获取 Superpowers# 拉取技能仓库gitclone https://github.com/agent-skills/superpowers.git2.2 配置方式一加载到 Hermes修改 Hermes 的config.yamlskill_plugins:paths:-./superpowers/skillsenable_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子任务拆分将任务拆分为可独立提交的单元一次提交改十几个文件难以 review3.2 自动触发机制与提示词的本质区别Superpowers 的技能是自动触发的不需要手动调用Agent 开始写功能代码 ↓ TDD 技能自动触发 ↓ 拦截请先编写测试用例 ↓ Agent 写出测试用例并通过 ↓ 放行允许编写业务代码 ↓ 代码写完 ↓ code-review-self 自动触发 ↓ 自动检查逻辑漏洞、边界条件、安全问题 ↓ commit-lint 拦截不规范提交跳步就会被拉回流程不用人每次提醒。3.3 全兼容可插拔兼容所有支持 Agent Skills 协议的 Agent可以全量加载 14 项技能也可以只选单个技能加载不需要改原有开发流程即插即用四、实操 Demo场景在用户模块上新增「禁用用户状态」字段第一步配置 Superpowers在 Hermes 配置中启用三个核心技能skill_plugins:paths:-./superpowers/skillsenable_skills:-tdd-first# 必须先写测试-code-review-self# 写完自动自评审-commit-lint# 提交必须符合规范第二步下发任务hermes chat基于现有用户模块新增禁用用户状态字段第三步Superpowers 强制拦截执行流程┌─────────────────────────────────────────────┐ │ 步骤 1TDD 技能触发 │ │ → 拦截直接写代码 │ │ → 要求先梳理测试场景 │ │ → 生成单元测试用例状态字段默认值、枚举校验等│ ├─────────────────────────────────────────────┤ │ 步骤 2强制写完测试用例并跑通 │ │ → 才允许进入编码阶段 │ ├─────────────────────────────────────────────┤ │ 步骤 3code-review-self 自动触发 │ │ → 检查逻辑漏洞 │ │ → 提示潜在边界问题如字段回滚、默认值处理 │ │ → Agent 修复问题后重新评审 │ ├─────────────────────────────────────────────┤ │ 步骤 4Git 提交 │ │ → commit-lint 校验 commit 格式 │ │ → 不合规直接拦截提交 │ │ → 格式feat(user): add disabled status field│ └─────────────────────────────────────────────┘五、适用场景✅ 最适合的场景场景原因中小型项目质量兜底轻量、便宜、无侵入守住 TDD 和评审底线个人开发标准化给单人开发加上工程纪律不靠自觉不想上重型规范但要保质量折中选择——没有 SpecKit 的文档成本但有执行护栏小团队协作统一执行纪律避免每个人开发方式不同与 SpecKit 搭配形成需求 Spec 执行 Superpowers双锁闭环⚠️ 需要配合其他工具的场景场景需要补充什么多人长期协作Superpowers 不定义需求标准需补 SpecKit强合规交付需补 SpecKit 做规格事实源 审计追溯团队扩大到 8 人以上需补 SpecKit 统一需求认知六、与其他工具的关系6.1 Superpowers vs SpecKit维度SpecKitSuperpowers管什么需求规格做什么、做成什么样执行纪律怎么做、按什么流程做作用时机事前——开发前定标准事中——开发中卡流程防什么需求漂移执行走样类比施工图产品/需求分析师监理技术主管能否独立用需配合编码 Agent需加载到编码 Agent为什么经常搭配着用只上 SpecKit规格写得再好Agent 执行时偷工减料、跳测试质量还是不稳只上 Superpowers纪律有了但多人协作没统一需求标准各理解各的二者搭配一个定标尺一个装护栏一个防需求跑偏一个防执行走样6.2 Superpowers vs 系统提示词Prompt这是面试高频追问。为什么不能直接写系统提示词来代替 Superpowers维度系统提示词Superpowers 技能稳定性单次的长会话中会被稀释常驻触发更稳定标准化靠人写团队里每个人质量不一样标准化封装统一标准约束力更多是提醒可以做流程校验和步骤拦截类比口头要求固化流程制度七、优势与局限总结优势优势说明轻量无侵入即插即用不需要改原有流程提高质量下限测试、评审、调试这些动作不再靠模型自觉灵活可配置可以全量加载也可以只启用单个技能自动触发不是手动命令跳步自动被拉回兼容性好所有支持 Agent Skills 协议的 Agent 都能用局限局限说明不能独立运行必须依赖底层编码 Agent不定义需求只约束过程不定义做什么需配合 SpecKit软约束属于引导式约束没有 SpecKit 那种硬拦截力度不适合代替 SpecKit多人协作仍需 SpecKit 来统一需求标准一句话总结Superpowers 是执行流程约束层前置拦截开发步骤强制 TDD、代码评审、自测、规范提交。它管的是开发过程不走样和 SpecKit 的需求不跑偏互补。提示词像口头要求技能插件更接近固化的流程制度。