34k Star！Claude skills项目superpowers开源，让智能体写出工程规范级代码

智猩猩AI整理

编辑：没方

在使用AI进行开发时，大家是否经历过这些场景？

一句需求，编程智能体立刻输出上千行看似逻辑缜密、格式工整，实则偏离核心目标的代码；

功能勉强“跑通”，但没有配套测试用例、代码耦合严重无法维护，最终只能重写；

想让编程智能体遵循工程规范、分步协作开发，却不得不手把手指挥，比自己写还累……

问题不仅出在智能体能力边界，更在于缺乏一套能够有效约束其开发行为、保障最终质量的系统性工程哲学指导。

为此，今天要给大家介绍一个Agent Skills开源项目superpowers。它重新定义了编程智能体参与软件开发的核心逻辑，将AI从一个急于炫技的“代码打字员”，彻底转变为严谨规范、高效协同的工程伙伴，为实现可靠的智能体开发迈出了关键性的一步。该项目在github上已收获 34k Star。

• 项目地址：https://github.com/obra/superpowers

01 项目介绍

Superpowers是一套完整的软件开发工作流，专为编程智能体（coding agent）打造。包括一组skills以及初始指令，确保用户的智能体能正确使用这些skills。

该项目从启动编程智能体就投入运行。当智能体发现用户正在构建项目时，它不会急于直接编写代码，而是先退一步，询问用户真正想要实现的目标。

通过对话梳理出需求后，智能体会分块展示设计方案，确保每个部分都便于阅读和理解。

当用户确认设计方案后，智能体会制定一份清晰的实施计划——即使对于缺乏判断力、不了解项目背景且不喜欢测试的初级工程师，也能轻松执行。该计划强调TDD、YAGNI、和DRY原则，有助于写出更清晰、更易于维护的代码。

当用户下达“开始”指令后，智能体会启动子智能体驱动开发流程，让子智能体逐一完成各项工程任务，同时对工作成果进行检查和评审，持续推进项目。通常情况下，Claude 能够连续数小时独立工作而不偏离制定的计划。

Superpowers的技能如下所示：

（1）基础工作流程

头脑风暴（brainstorming）：编写代码前激活。通过提问细化粗略想法，探索替代方案，分模块展示设计方案供用户验证，并保存设计文档。

使用 Git 工作树（using-git-worktrees）：设计方案通过批准后激活。在新分支创建独立工作区，完成项目初始化，验证干净的测试基线。

编写计划（writing-plans）：设计方案通过批准后激活。将工作拆分为 2-5 分钟可完成的小型任务，每个任务都包含精确文件路径、完整代码和验证步骤。

子智能体驱动开发 / 执行计划（subagent-driven-development /executing-plans）：设计方案通过批准后激活。为每个任务分配全新子智能体，执行两阶段评审（先验证是否符合规格，再检查代码质量）；或批量执行任务并设置人工检查点。

测试驱动开发（test-driven-development）：实施阶段激活。强制遵循红-绿-重构流程：编写失败测试用例 → 观察失败 → 编写最简代码 → 观察通过 → 提交。删除测试前编写的代码。

请求代码评审（requesting-code-review）：任务间激活。对照计划进行评审，按严重程度报告问题，关键问题将阻塞项目进度。

完成开发分支（finishing-a-development-branch）：任务完成后激活。验证测试，提供选项（合并/拉取请求/保留/丢弃），清理工作树。

智能体在执行任何任务前都会检查相关技能，这些是强制工作流而非可选。

02 使用方法

（1）在 Claude Code 中安装

先注册插件市场：

/plugin marketplace add obra/superpowers-marketplace

然后从该市场安装插件：

/plugin install superpowers@superpowers-marketplace

检查命令是否出现：

/help

看到以下内容：

# /superpowers:brainstorm - 交互式设计细化

# /superpowers:write-plan - 创建实施计划

# /superpowers:execute-plan - 批量执行计划

（2）在Codex中安装

快速安装：

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

手动安装：

mkdir -p ~/.codex/superpowers

git clone https://github.com/obra/superpowers.git ~/.codex/superpowers

引导文件已包含在仓库中，路径为 .codex/superpowers-bootstrap.md，Codex 会从克隆后的目录自动加载该文件。

验证安装：

~/.codex/superpowers/.codex/superpowers-codex find-skills to show available skills

会看到一份可用技能列表和描述。

查找技能：

~/.codex/superpowers/.codex/superpowers-codex find-skills

加载技能：

~/.codex/superpowers/.codex/superpowers-codex use-skill superpowers:brainstorming

加载包含所有技能信息的完整引导配置：

~/.codex/superpowers/.codex/superpowers-codex bootstrap

（3）在OpenCode中安装

在OpenCode输入以下指令，快速安装：

Clone https://github.com/obra/superpowers to ~/.config/opencode/superpowers, then create directory ~/.config/opencode/plugin, then symlink ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js to ~/.config/opencode/plugin/superpowers.js, then restart opencode.

手动安装：

mkdir -p ~/.config/opencode/superpowers

git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers

注册插件：

OpenCode 会从 ~/.config/opencode/plugin/ 中发现插件。创建一个符号链接：

mkdir -p ~/.config/opencode/plugin

ln -sf ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js ~/.config/opencode/plugin/superpowers.js

或者在项目本地安装：

# 在OpenCode项目中执行

mkdir -p .opencode/plugin

ln -sf ~/.config/opencode/superpowers/.opencode/plugin/superpowers.js .opencode/plugin/superpowers.js

重启 OpenCode 以加载插件，Superpowers 会自动激活。

查找技能：

use find_skills tool

加载技能：

use use_skill tool with skill_name: "superpowers:brainstorming"

技能会自动插入对话，并在上下文压缩后依然保留。

03 总结

Superpowers这类工具的出现，让AI不仅是代码助手，更是可靠的工程合作伙伴。它打破了以往智能体生成代码看似工整却偏离目标、能跑通却难维护的壁垒，以一套严谨规范的强制工作流和技能将编程任务高效落地。让开发者真正做到放心托付，将更多精力放在架构设计、业务逻辑和创新思考上。