乐于分享
好东西不私藏

用好这个工具,让你的AI工具更上一层楼—— Superpowers,硬盘里的贾维斯

用好这个工具,让你的AI工具更上一层楼—— Superpowers,硬盘里的贾维斯

你有没有这样过,让AI写代码,它噼里啪啦输出一堆,结果跑不通、没测试、还夹带一堆用不上的炫技逻辑?

你反复纠正,它却像一头倔驴,越改越偏。不是AI不聪明,而是你缺了一套能让它听话干活的工程纪律。

今天的主角——Superpowers,是一套让AI Agent真正像软件工程师一样工作的框架。它不改变AI模型,而是给AI一套行为准则,让AI在指定的方向上奔跑。目前已经122K的star。

1. Superpowers解决了什么问题?

当前很多AI编程的痛点很明显:

  • 无需求澄清:AI直接写代码,很多问题不问直接写;

  • 无计划:直接写代码,不拆解任务;

  • 无测试:代码写完,不写测试,不验证;

结果就是:AI产出的代码,质量不稳定、难以维护、无法协作。更糟的是,你得花大量时间纠正它,而不是让它帮你干活。

Superpowers 是怎么做的?给AI一套软件工程师行为准则,让它像一个有经验的老程序猿一样工作。

2. Superpowers 具体是怎么做的?

Superpowers 的核心是skills + 强制工作流。

内嵌的工作流:

阶段名称
激活条件/时机
操作描述
brainstorming
编程前 (Before writing code)
通过提问细化粗略想法、探索替代方案、分模块展示设计以验证、保存设计文档。
using-git-worktrees
设计审批后 (After design approval)
在新分支创建隔离工作区、运行项目初始化、验证测试基线是否清洁。
writing-plans
设计审批后(With approved design)
将工作拆解为 2-5 分钟的微任务;每个任务包含精确文件路径、完整代码、验证步骤。
subagent-driven-development or executing-plans
有可用计划 (With plan)
每个任务派发新子代理(分两阶段评审:规格合规性→代码质量),或批量执行并设人工检查点。
test-driven-development
实现阶段(During implementation)
强制执行红绿重构流程:编写失败测试→见证失败→编写最少代码→见证通过→提交;删除未通过测试的代码。
requesting-code-review
任务间(Between tasks)
基于计划评审代码、按严重性报告问题;关键问题阻塞进度。
finishing-a-development-branch
任务全部完成后 (When tasks complete)
验证测试状态、提供操作选项(合并/拉取请求/保留/丢弃)、清理工作区。

内置的Skills:

Skill名称
作用
触发条件(自动/手动)
brainstorming
通过提问澄清需求,生成设计文档
自动触发(需求模糊时系统自动触发)
dispatching-parallel-agents
分派独立任务给并行代理,处理无共享状态的多任务
自动触发(检测到2+个独立任务时系统自动触发)
executing-plans
执行书面实施计划,在独立会话中落地并配合审查检查
手动触发(需输入/superpowers:execute-plan命令)
finishing-a-development-branch
处理开发分支完成后的集成决策(合并/清理)
自动触发(检测到所有测试通过且任务完成时系统自动触发)
receiving-code-review
处理代码审查反馈,落地重大修改建议
自动触发(收到代码审查反馈时系统自动触发)
requesting-code-review
在提交前请求代码审查,确保符合要求
自动触发(完成主要功能或准备合并时系统自动触发)
subagent-driven-development
通过子代理执行独立任务,推进实施计划
自动触发(执行实施计划中包含独立任务时系统自动触发)
systematic-debugging
系统化排查bug、测试失败,提出修复方案前的前置分析
自动触发(检测到bug/测试失败时系统自动触发)
test-driven-development
为功能/bugfix编写测试用例,指导后续编码
自动触发(开始写实现代码前系统自动触发)
using-git-worktrees
通过Git工作树隔离特性分支工作区,准备独立环境
自动触发(需要隔离环境时系统自动触发)
using-superpowers
建立技能调用机制,是技能系统的入口
自动触发(每次对话初始化时系统自动触发)
verification-before-completion
在声称完成前进行验证(测试/代码审查)
自动触发(准备提交/完成时系统自动触发)
writing-plans
基于需求撰写多步实施计划
自动触发(拥有需求文档且开始写代码前系统自动触发)
writing-skills
创建/编辑新技能或验证技能部署
手动触发(需输入/superpowers:write-skill命令)

自动触发:系统根据上下文条件,如需求模糊、测试通过、检测到bug。无需用户输入命令自动执行;

手动触发:需用户主动输入特定命令,如/superpowers:execute-plan,才启动;

典型工作流:brainstorming(自动)→ 用户确认需求 → writing-plans(自动)→ 用户输入/superpowers:execute-plan(手动)→ test-driven-development(自动)→ finishing-a-development-branch(自动);

3. 如何使用?

1. 安装

对于Claude Code用户,可直接执行:

/plugin install superpowers@claude-plugins-official

对于Cursor用户可直接在对话框输入:

/add-plugin superpowers

对于OpenCode用户,可直接执行:

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

2. 开始使用

直接描述需求,比如:帮我加个用户登录功能

AI 会自动触发 brainstorming 技能,开始问你问题:

“你需要支持哪种登录方式?(邮箱/手机号/第三方登录)”

3. 确认方案,启动执行

确认设计后,输入:/superpowers:write-plan

AI 会生成一份详细的实施计划,如:

1. 创建 login.html   - 验证:页面加载后显示登录表单2. 实现登录API   - 验证:POST /login 返回 JWT......

然后输入:/superpowers:execute-plan

AI 会自动执行计划,每一步都严格按 TDD 流程:

  • 先写测试(RED)

  • 再写代码(GREEN)

  • 最后重构(REFACTOR)

PS:你可以用 /superpowers:help 查看所有可用技能。

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

请在微信客户端打开