Superpowers环境配置:3步给编码Agent装上13项核心开发技能
2026/9/16 9:48:55 网站建设 项目流程

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 步流程

技能是自动触发的,你不用记命令。典型一次开发会按这个顺序走:

  1. brainstorming:动手前先追问清楚你要做什么,分段给你看设计
  2. using-git-worktrees:在新分支建隔离工作区,按 package.json / requirements.txt / pyproject.toml 自动跑 npm install 或 pip/poetry 装依赖,并验证测试基线是干净的
  3. writing-plans:拆成 2-5 分钟一个的任务,每个任务带文件路径和验证步骤
  4. subagent-driven-development:每个任务派新子代理实现,规格符合性和代码质量两段评审
  5. test-driven-development:强制 RED-GREEN-REFACTOR,测试前写的代码会被删掉
  6. requesting-code-review:任务间对照计划评审,critical 问题阻塞推进
  7. 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),仅供参考

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

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

立即咨询