Superpowers环境配置:3步给编码Agent装上13项核心开发技能
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一套面向 AI 编码 Agent 的可组合技能库和方法论:接到需求后它会先和你打磨设计,再建隔离工作区、拆任务、派子代理逐个实现,全程走 TDD 和代码评审。适合已经在使用 Claude Code、OpenCode、Gemini CLI 等编码 Agent、希望它按规范流程干活的用户。本文覆盖安装、验证、Windows 兼容三类最常见的配置问题。
按你用的 Agent 选安装方式
Superpowers 按 harness 独立安装:同时用 Claude Code 和 OpenCode 的话,两边各装一份,不共享。
Claude Code:一条命令装完
在会话里直接执行:
/plugin install superpowers@superpowers-marketplace首次安装前如果提示市场未注册,按提示先执行一次 marketplace add 即可。装完后 Agent 从下一条消息起自动生效。
OpenCode:改一行配置
在opencode.json(全局或项目级)的plugin数组里加一条 superpowers 的插件声明,然后重启。如果网络拉取 git 依赖失败,先把仓库克隆到本地再指向本地路径:
git clone https://gitcode.com/GitHub_Trending/su/superpowers遇到"插件加载了但技能列表是空的",用opencode run --print-logs过滤 superpowers 关键字看日志,通常是插件路径写错。
其他 Agent:查 Quickstart
Gemini CLI、Cursor、Codex、Copilot CLI、Kimi Code 等各有各的一行安装命令,都列在 README.md 的 Quickstart 一节,按对应 harness 复制即可。
30秒验证环境是否配好
重启 Agent 后,直接在对话里问一句"Tell me about your superpowers"。能正确列出 brainstorming、test-driven-development 等技能清单,说明配置成功;OpenCode 上也可以用它的 skill 工具列出已注册技能。如果只列出部分技能,先确认配置里的插件路径没多一层目录,再重启一次。
Windows 上的两个坑
- 钩子依赖 bash。Superpowers 的会话钩子由
hooks/run-hook.cmd这个跨平台调度器执行,它会在C:\Program Files\Git\bin等三处找 bash;找不到时不报错,而是静默跳过钩子。所以 Windows 上"装了但没效果",九成是没装 Git for Windows 或路径不对。 - 手动建目录链接时用 junction。需要把技能目录挂进配置目录时,推荐
mklink /J创建 junction,比符号链接兼容性好。
调度器的完整原理和排查清单见 docs/windows/polyglot-hooks.md。
装完后:Agent 自动跑的 7 步流程
技能是自动触发的,你不用记命令。典型一次开发会按这个顺序走:
- brainstorming:动手前先追问清楚你要做什么,分段给你看设计
- using-git-worktrees:在新分支建隔离工作区,按 package.json / requirements.txt / pyproject.toml 自动跑 npm install 或 pip/poetry 装依赖,并验证测试基线是干净的
- writing-plans:拆成 2-5 分钟一个的任务,每个任务带文件路径和验证步骤
- subagent-driven-development:每个任务派新子代理实现,规格符合性和代码质量两段评审
- test-driven-development:强制 RED-GREEN-REFACTOR,测试前写的代码会被删掉
- requesting-code-review:任务间对照计划评审,critical 问题阻塞推进
- finishing-a-development-branch:收尾时验证测试,给你 merge / PR / 保留 / 丢弃的选项
迁移旧安装与一个可选设置
- 以前用 git clone + 软链接装 OpenCode 版的,先删掉
~/.config/opencode下的旧链接和克隆目录,再按上面的新流程来,步骤细节在 docs/README.opencode.md。 - brainstorming 的可视化伴侣默认会加载一个带版本号的 logo,属于可选遥测;不想上报的话,把环境变量
SUPERPOWERS_DISABLE_TELEMETRY设成任意真值即可。
下一步建议:如果想给自己的项目加自定义技能,直接读 skills/writing-skills/SKILL.md,里面是完整的编写与测试方法。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考