☰
Agent之skills:Superpowers(Coding Agents/ Agentic Skills Framework)的简介、安装和使用方法、案例应用之详细攻略
2026/10/12 18:36:43 网站建设 项目流程

Agent之skills:Superpowers(Coding Agents/ Agentic Skills Framework)的简介、安装和使用方法、案例应用之详细攻略

目录

Superpowers的简介

1、特点

Superpowers的安装和使用方法

1、安装

T1、Claude Code

T2、Codex CLI

T3、Codex App

T4、Factory Droid

T5、Gemini CLI

T6、Cursor

T7、GitHub Copilot CLI

T8、OpenCode

2、使用方法

(1)Brainstorming(需求讨论)

(2)Using Git Worktrees

(3)Writing Plans

(4)Subagent Driven Development

(5)Test Driven Development

(6)Requesting Code Review

(7)Finishing Development Branch

Superpowers的案例应用

AI 辅助的新功能开发—使用 Superpowers 完成一个新功能开发流程

测试驱动的软件开发— 利用 Test-Driven Development 保证代码质量

系统化调试问题定位——使用 Systematic Debugging 快速定位缺陷

团队协同代码审查—利用 Code Review 提升开发质量

基于 Git Worktree 的安全分支开发


Superpowers的简介

Superpowers 是一个面向 AI 编程代理(Coding Agents)的 Agentic Skills Framework(智能代理技能框架) 与 软件开发方法论。项目并非单纯提供一组提示词(Prompt),而是通过一系列可组合(Composable)的技能(Skills)以及初始化指令,使 AI 编程助手能够按照规范的软件工程流程完成需求分析、方案设计、任务规划、代码开发、测试、代码审查以及分支收尾等完整生命周期。其目标是在 AI 编程过程中,以工程化的方法替代随意编码,从而提升代码质量、开发效率和可维护性。

Superpowers 的核心思想是:让 AI 在真正开始写代码之前,先理解需求,再设计方案,然后制定实施计划,最后按照测试驱动开发(TDD)等最佳实践执行开发工作。整个流程强调 Brainstorm(需求讨论)、Specification(规格设计)、Planning(任务规划)、Subagent Driven Development(子代理协同开发)、Test-Driven Development(测试驱动开发)、Code Review(代码审查)等多个阶段,并能够自动触发对应技能,而不是依赖用户手动调用。

目前,Superpowers 已支持多种主流 AI 编程平台,包括 Claude Code、Codex CLI、Codex App、Cursor、Gemini CLI、GitHub Copilot CLI、OpenCode、Factory Droid 等。对于不同平台,项目提供对应的插件安装方式,使开发者能够在熟悉的开发环境中使用统一的软件开发方法论。

Github地址:GitHub - obra/superpowers: An agentic skills framework & software development methodology that works. · GitHub

1、特点

特点

详细说明

完整的软件开发方法论

不仅提供提示词,而是覆盖需求分析、设计、开发、测试、审查、交付整个软件生命周期。

自动技能触发

AI Agent 在执行任务前会自动检查适用技能,并按既定流程执行,而非依赖用户手动调用。

需求优先

AI 不会立即开始编写代码,而是首先通过交流明确用户真正需求,并整理为规格说明(Specification)。

分阶段设计确认

将设计内容拆分成多个易阅读的部分,与用户逐步确认设计方案。

自动生成实施计划

根据已确认的设计,生成细粒度开发计划,每个任务通常控制在 2~5 分钟,可直接执行。

子代理协同开发

利用多个 Subagent 分工完成不同开发任务,并进行两阶段审查(规格符合性、代码质量)。

测试驱动开发(TDD)

强制遵循 RED-GREEN-REFACTOR 开发流程,即先写失败测试,再实现代码,再重构优化。

Git Worktree 工作流

自动创建隔离开发环境和独立分支,避免影响主开发分支。

系统化调试

提供四阶段 Root Cause 调试流程,并强调问题验证而非主观判断。

强调代码审查

每个开发阶段均可触发代码审查,关键问题未解决前不会继续执行后续任务。

强调工程最佳实践

贯彻 YAGNI(You Aren't Gonna Need It)、DRY(Don't Repeat Yourself)、Evidence over Claims(以验证代替猜测)等工程原则。

丰富技能库

内置测试、调试、规划、协同开发、代码审查、技能编写等多个技能模块,可组合使用。

Superpowers的安装和使用方法

1、安装

由于 Superpowers 面向多个 AI 编程平台,因此安装方式因平台而异,官方建议每个平台分别安装一次插件。

T1、Claude Code

/plugin install superpowers@claude-plugins-official 或者: 先添加 Marketplace: /plugin marketplace add obra/superpowers-marketplace 然后安装: /plugin install superpowers@superpowers-marketplace

T2、Codex CLI

打开插件界面:/plugins
搜索:superpowers
点击 Install Plugin 完成安装。

T3、Codex App

进入:Plugins,Coding 分类
找到 Superpowers,点击 + 安装即可。

T4、Factory Droid

注册 Marketplace:droid plugin marketplace add https://github.com/obra/superpowers 安装: droid plugin install superpowers@superpowers

T5、Gemini CLI

安装: gemini extensions install https://github.com/obra/superpowers 更新: gemini extensions update superpowers

T6、Cursor

Agent Chat 中执行:

/add-plugin superpowers

也可以直接在 Plugin Marketplace 搜索 Superpowers 安装。

T7、GitHub Copilot CLI

注册 Marketplace: copilot plugin marketplace add obra/superpowers-marketplace 安装: copilot plugin install superpowers@superpowers-marketplace

T8、OpenCode

按照官方要求执行安装说明:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

详细安装文档位于:

docs/README.opencode.md

以上安装方式均来自官方 README。

2、使用方法

Superpowers 的核心使用方式是遵循官方定义的软件开发流程,主要包括以下几个阶段:

(1)Brainstorming(需求讨论)

当用户提出开发需求时,AI 不会立即生成代码,而是首先:
询问真正需求
澄清业务目标
探索不同实现方案
输出设计内容
与用户逐步确认设计
最终保存设计文档(Specification)。

(2)Using Git Worktrees

设计确认后:
创建新的开发分支
创建隔离工作目录(Worktree)
初始化项目
验证测试环境是否正常
保证开发不会影响当前主分支。

(3)Writing Plans

依据设计文档:
将开发任务拆分为多个小任务(通常 2~5 分钟)
每个任务明确文件路径
指定需要修改的代码
提供验证步骤
形成可执行实施计划。

(4)Subagent Driven Development

计划确认后:
每个任务由新的 Subagent 执行
先检查是否符合规格说明
再检查代码质量
合格后继续下一任务
整个过程支持连续自动开发较长时间。

(5)Test Driven Development

实现阶段严格执行:
编写失败测试(RED)
运行测试确认失败
编写最少代码
测试通过(GREEN)
重构(REFACTOR)
项目强调先测试、后编码。

(6)Requesting Code Review

任务之间自动进行代码审查:
检查是否符合开发计划
标记问题严重程度
严重问题必须修复后才能继续
确保开发质量。

(7)Finishing Development Branch

开发结束后:
验证所有测试
提供 Merge、Pull Request、保留分支或删除分支等处理选项
清理 Worktree
完成整个开发生命周期。

Superpowers的案例应用

AI 辅助的新功能开发—使用 Superpowers 完成一个新功能开发流程

开发者提出新的功能需求后,Superpowers 首先自动进入 Brainstorming 阶段,与开发者不断交流需求细节,并整理形成设计文档;设计确认后,系统自动生成详细实施计划,将工作拆分为多个可执行的小任务。随后进入 Subagent Driven Development,每个任务由独立子代理完成,并结合 TDD 编写测试、实现代码和执行重构,同时在任务之间自动发起代码审查。最终完成全部任务后,验证测试结果,并提供合并或创建 Pull Request 等分支收尾选项,实现完整的软件开发流程。

测试驱动的软件开发—利用 Test-Driven Development 保证代码质量

在编码过程中,Superpowers 自动启用 Test-Driven Development 技能,要求首先编写失败测试(RED),验证测试确实失败后,再实现满足测试的最小代码(GREEN),最后执行重构(REFACTOR)。项目明确强调遵循 RED-GREEN-REFACTOR 循环,并要求删除未经过测试验证的代码,以确保开发过程始终建立在可验证的测试基础之上。

系统化调试问题定位——使用 Systematic Debugging 快速定位缺陷

当项目出现 Bug 时,Superpowers 提供 Systematic Debugging 技能,采用四阶段根因分析流程(Root Cause Process)进行问题定位,并结合 Root Cause Tracing、Defense in Depth、Condition-Based Waiting 等调试技术逐步分析问题原因。同时配合 Verification Before Completion 技能,在修复完成后进一步验证问题是否真正解决,而不是仅依据现象判断修复成功。

团队协同代码审查—利用 Code Review 提升开发质量

在开发任务完成后,Superpowers 自动进入 Requesting Code Review 阶段,根据既定开发计划检查实现是否符合规格要求,并按问题严重程度输出审查结果。若存在关键问题,则阻止继续执行后续任务;只有在问题修复并通过审查后,才进入下一阶段,从而形成规范化的软件质量保障流程。

基于 Git Worktree 的安全分支开发

设计确认后,Superpowers 自动创建新的 Git Worktree 和独立开发分支,在隔离环境中完成项目初始化和测试基线验证。整个开发过程不会直接影响主分支;待全部任务完成并通过测试后,再由开发者选择合并、创建 Pull Request、保留分支或删除分支等方式结束开发,实现更加安全、规范的分支管理流程。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询