Superpowers 最简环境配置：5 分钟搭好你的 AI 开发工作空间
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一套面向编码代理的 AI 开发工具与技能库：它把系统化调试、TDD、代码评审这些工程方法论打包成会自动触发的技能。这篇文章带你走一遍 Superpowers 环境配置的最短路径——从安装到验证，再到各系统差异和常见坑，看完你就能让 AI 按规范干活，而不是随手写码。
先看到结果：装完后省掉了什么
装好 Superpowers 之后，你提需求时代理不会再一上来就写代码。它先和你确认"到底要做什么"，把设计切成能读懂的小段给你过目；你拍板后它产出可执行计划，再派子代理逐条实现、逐项评审，常常能自主连跑几个小时不跑偏。
换句话说，你省掉的是三样东西：手动给代理补流程约束的对话成本、反复审查"为什么不写测试"的精力、以及分支被半路改乱的清理时间。环境配置本身，只需要几分钟。
一条命令装好 Superpowers：最短可用路径
Superpowers 安装步骤的核心就三步：确认依赖、装插件、验证。过去要查文档、建目录、配链接，现在一条命令。
node --version git --version /plugin install superpowers@superpowers-marketplace装完怎么确认没问题？问一句"Tell me about your superpowers"，它答得出技能列表，就是装好了。如果还想落一步实锤，看看技能目录是否存在：
ls ~/.config/superpowers/skills不同系统的差异一览：Windows / Linux / macOS
装一次，全平台通用——技能逻辑本身与平台无关，差异只在"怎么把技能挂给代理"这一步：
- Windows：shell 有 cmd / PowerShell / Git Bash 之分，hooks 走的是跨平台分发脚本；符号链接若失败，用目录 junction 代替。细节见 docs/windows/polyglot-hooks.md。
- Linux / macOS：一条
ln -sf的符号链接即可手动挂载技能目录，安全支持重装。 - 各代理的插件市场：Claude Code、Codex CLI、Cursor、Gemini CLI、Kimi Code、OpenCode 各有各的安装入口，命令见下表。
| 代理 | 安装方式 |
|---|---|
| Claude Code | /plugin install superpowers@superpowers-marketplace |
| Codex CLI | 打开/plugins，搜索 superpowers 后选择 Install |
| Cursor | 聊天里输入/add-plugin superpowers |
| Gemini CLI | gemini extensions install后跟仓库地址 |
| Kimi Code | 插件市场 Marketplace 里找 Superpowers |
| OpenCode | 在 opencode.json 的 plugin 数组里加 superpowers |
它替你做了什么：依赖初始化不用你管
新建隔离工作空间时，Superpowers 会先看项目"长什么样"，再决定跑哪条安装命令：项目根目录有package.json就跑npm install，有requirements.txt就pip install，有pyproject.toml就poetry install，Rust 和 Go 项目也各有对应处理。装完依赖还会顺手跑一遍测试，确认起点是干净的基线。
对你来说这意味着：不用记任何一条 setup 命令，依赖装错了也有基线测试兜底报警。
进阶玩法：隔离开发与旧版迁移
- Git Worktrees 隔离开发：适合要并行开几个分支、或不想污染当前工作区的人。让代理按 using-git-worktrees 技能建 worktree，它会先检测你是否已在隔离空间，再自动跑项目 setup 和基线测试，开不回来就原地干活，绝不硬来。
- 旧版本迁移：适合之前用
git clone加符号链接手动装过的人。把旧的链接和克隆目录清掉、删掉相关配置项，再按上面的步骤装新版即可；技能文件统一放在各平台的 skills 目录下，互不冲突。
踩坑速查：常见问题与解法
| 问题 | 快速解法 |
|---|---|
| 依赖装不上 | 检查网络与代理；Node、Git 是否在 PATH 里 |
| Windows 符号链接失败 | 用mklink /J建目录 junction；或管理员权限重试 |
| 技能没被识别 | 确认每个技能目录有SKILL.md；重启代理会话 |
| 更新后没生效 | 清一下插件缓存，再重装一次 |
| 权限不足报错 | 换到用户目录操作，或以管理员身份运行终端 |
Superpowers 环境配置就到这里：装一次，全平台通用；剩下的，交给会自动触发的技能。想深入某个技能怎么工作，直接翻 skills/ 目录，每个技能都有一个 SKILL.md 讲清楚触发时机和做法。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
