Superpowers 技能库多场景实战个人、团队与 CI 的完整接入路径【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 技能库把你团队的开发方法论写成一组可被 AI 编码代理自动触发的技能代理先澄清需求、再拆解计划、按 TDD 逐任务执行并逐任务审查。当你发现团队里 3 个人各维护一套 prompt 模板、每次让代理写代码都先跑偏时它解决的就是这个痛点。装好之后你在 Claude Code、OpenCode、Codex 等工具里新开一个会话代理会自己按流程走你不需要额外下指令。30 秒看懂技能库怎么工作技能 目录 一份 SKILL.md。skills/ 下每个技能一个目录SKILL.md 头部的 YAML 前置声明 name 与 description正文是代理要执行的规则目录里还可以放配套模板例如 subagent-driven-development 就附带了 implementer-prompt.md 等提示词文件。仓库内置 14 个技能覆盖 brainstorming、writing-plans、test-driven-development、systematic-debugging 等场景。会话启动时自动注入引导上下文。hooks/hooks.json——钩子注册文件——在 startup/clear/compact 三种时机触发 hooks/session-start——会话启动脚本它读取 skills/using-superpowers/SKILL.md 全文注入对话并按当前平台输出对应字段{ hooks: { SessionStart: [{ matcher: startup|clear|compact, hooks: [{ type: command, command: \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\ session-start, shell: bash }] }] } }代理在每个动作前自查技能。注入的规则要求代理回应前先检查相关技能并声明 Using [skill] to [purpose]多技能同时命中时brainstorming、systematic-debugging 这类流程技能先加载。技能优先级是项目技能 个人技能 内置技能团队定制就发生在这个顺序上。个人环境 3 步跑通目标5 分钟内验证技能库在你的编码代理里已加载、可触发。准备一个 Git 客户端以及任意一款受支持的编码代理 CLI安装方式见 README.md 的各工具章节。操作克隆技能库并查看内置技能清单git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers ls skills/你应该看到 14 个技能目录brainstorming、subagent-driven-development 都在其中。按你使用的工具安装Claude Code 在会话里输入 /plugin install superpowersclaude-plugins-officialOpenCode 按 docs/README.opencode.md——OpenCode 安装指南——把 superpowers 加进 opencode.json 的 plugin 数组然后重启。新开会话直接问 Tell me about your superpowers。验证代理会复述技能列表并声明动手前会先检查技能。再发一句 帮我 brainstorm 一个记账功能如果它以 Using brainstorming to ... 开头回答注入与自动触发都通了。到这里基础环境就通了。brainstorming 结束后还会把设计文档存进 docs/superpowers/specs/ 目录仓库里已沉淀了多份历史设计文档可直接参考格式。团队共享用技能优先级覆盖内置行为目标把团队评审规范写成一个技能提交进仓库全员共享个人偏好走个人技能不污染仓库。准备确认你用的平台遵循 项目技能 个人技能 内置技能 的顺序OpenCode 明确采用这个顺序团队技能放进项目即可覆盖内置版本。操作在仓库根目录建团队技能目录mkdir -p .opencode/skills/team-review写入 SKILL.md前置字段 name 与目录同名description 写清触发条件--- name: team-review description: Use when opening a pull request - team review checklist ---个人覆盖技能放~/.config/opencode/skills/结构相同团队技能进 Git 随仓库分发个人技能留在本机。提交前跑一次触发验证确认代理真的会调用它./tests/explicit-skill-requests/run-test.sh team-review 你的提示词文件——单技能触发验证脚本它会跑真实会话并检查技能是否被触发。验证新会话里让代理列出技能team-review 应在列表中当同名个人技能存在时代理执行的是个人版本团队技能保持原样。 CI 里加一个技能触发验证目标技能没加载、或提示词不再触发技能时流水线直接失败而不是等合并后才发现。准备CI runner 上装好 Node.js 与对应代理 CLItests/claude-code 的测试要求 claude 命令可用并把仓库 checkout 到工作目录。操作在流水线里克隆仓库后执行# 1) 全量快速技能测试默认每测试 300 秒超时CI 放宽到 900 cd tests/claude-code ./run-skill-tests.sh --timeout 900 # 2) 单独验证某个技能能否被显式请求触发 cd ../.. ./tests/explicit-skill-requests/run-test.sh systematic-debugging \ tests/explicit-skill-requests/prompts/use-systematic-debugging.txtrun-skill-tests.sh——技能快速测试入口——退出码 0 即通过tests/claude-code/test-helpers.sh 里的 run_claude、assert_contains 等断言函数负责逐条校验。看 run-test.sh 的输出命中时打印 PASS: Skill ... was triggered并列出本次实际触发的全部技能。验证故意改坏某个 SKILL.md 的前置字段再跑一次对应测试应当 FAIL——这一步能证明你的验证真的在起作用。⚡ 避坑你大概率会踩的 4 个坑坑 1代理无视技能直接写代码现象新会话里代理不声明 Using ... 就开写。原因session-start 钩子没跑引导上下文没注入常见于手动拷贝文件而非走插件机制安装。解法opencode run --print-logs hello 21 | grep -i superpowers日志里没有 superpowers 就按插件机制重装。坑 2技能列表里少了某个技能现象代理列技能时缺一项。原因该目录缺 SKILL.md或 YAML 前置字段不合法缺 name/description 或 --- 未闭合。解法grep -r ^description: skills/ --includeSKILL.md正常应输出 14 行少一行就是哪个技能出了问题。坑 3更新后代理还是旧行为现象拉到新提交行为没变。原因基于 git 的插件规格会把解析到的版本钉在 lockfile 或缓存里重启后不一定拿到新提交。解法清掉 OpenCode 的包缓存或重新安装插件需要稳定时按 tag 钉住具体版本。坑 4内网合规检查到外部请求现象企业内网环境监控到出站流量。原因brainstorming 可视化伴侣的 logo 默认从官网加载会带上你本地的 Superpowers 版本号不含任何项目内容。解法export SUPERPOWERS_DISABLE_TELEMETRY1该变量设任意真值即关闭。进阶调优参数参数默认值建议值作用位置--timeout300 秒/测试CI 用 900tests/claude-code/run-skill-tests.shmax-turns3保持 3tests/explicit-skill-requests/run-test.sh钩子 matcherstartup|clear|compact保持默认hooks/hooks.jsonSUPERPOWERS_DISABLE_TELEMETRY未设置开启内网设为 1brainstorming 可视化伴侣插件版本规格main 分支按 tag 钉住OpenCode 的 opencode.json日常保持全部默认即可CI 里只调 --timeout内网环境关掉遥测其余参数动它之前先想清楚为什么。Superpowers 的设计目标是让这套工作流成为强制项而不是建议技能加载后代理在每次动作前自查流程就不会被跳过。完整的支持工具列表与安装方式见仓库 README.md测试架构概览见 docs/testing.md从个人到 CI剩下的就是按场景把对应的验证跑起来。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Superpowers 技能库多场景实战：个人、团队与 CI 的完整接入路径
Superpowers 技能库多场景实战个人、团队与 CI 的完整接入路径【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 技能库把你团队的开发方法论写成一组可被 AI 编码代理自动触发的技能代理先澄清需求、再拆解计划、按 TDD 逐任务执行并逐任务审查。当你发现团队里 3 个人各维护一套 prompt 模板、每次让代理写代码都先跑偏时它解决的就是这个痛点。装好之后你在 Claude Code、OpenCode、Codex 等工具里新开一个会话代理会自己按流程走你不需要额外下指令。30 秒看懂技能库怎么工作技能 目录 一份 SKILL.md。skills/ 下每个技能一个目录SKILL.md 头部的 YAML 前置声明 name 与 description正文是代理要执行的规则目录里还可以放配套模板例如 subagent-driven-development 就附带了 implementer-prompt.md 等提示词文件。仓库内置 14 个技能覆盖 brainstorming、writing-plans、test-driven-development、systematic-debugging 等场景。会话启动时自动注入引导上下文。hooks/hooks.json——钩子注册文件——在 startup/clear/compact 三种时机触发 hooks/session-start——会话启动脚本它读取 skills/using-superpowers/SKILL.md 全文注入对话并按当前平台输出对应字段{ hooks: { SessionStart: [{ matcher: startup|clear|compact, hooks: [{ type: command, command: \${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\ session-start, shell: bash }] }] } }代理在每个动作前自查技能。注入的规则要求代理回应前先检查相关技能并声明 Using [skill] to [purpose]多技能同时命中时brainstorming、systematic-debugging 这类流程技能先加载。技能优先级是项目技能 个人技能 内置技能团队定制就发生在这个顺序上。个人环境 3 步跑通目标5 分钟内验证技能库在你的编码代理里已加载、可触发。准备一个 Git 客户端以及任意一款受支持的编码代理 CLI安装方式见 README.md 的各工具章节。操作克隆技能库并查看内置技能清单git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers ls skills/你应该看到 14 个技能目录brainstorming、subagent-driven-development 都在其中。按你使用的工具安装Claude Code 在会话里输入 /plugin install superpowersclaude-plugins-officialOpenCode 按 docs/README.opencode.md——OpenCode 安装指南——把 superpowers 加进 opencode.json 的 plugin 数组然后重启。新开会话直接问 Tell me about your superpowers。验证代理会复述技能列表并声明动手前会先检查技能。再发一句 帮我 brainstorm 一个记账功能如果它以 Using brainstorming to ... 开头回答注入与自动触发都通了。到这里基础环境就通了。brainstorming 结束后还会把设计文档存进 docs/superpowers/specs/ 目录仓库里已沉淀了多份历史设计文档可直接参考格式。团队共享用技能优先级覆盖内置行为目标把团队评审规范写成一个技能提交进仓库全员共享个人偏好走个人技能不污染仓库。准备确认你用的平台遵循 项目技能 个人技能 内置技能 的顺序OpenCode 明确采用这个顺序团队技能放进项目即可覆盖内置版本。操作在仓库根目录建团队技能目录mkdir -p .opencode/skills/team-review写入 SKILL.md前置字段 name 与目录同名description 写清触发条件--- name: team-review description: Use when opening a pull request - team review checklist ---个人覆盖技能放~/.config/opencode/skills/结构相同团队技能进 Git 随仓库分发个人技能留在本机。提交前跑一次触发验证确认代理真的会调用它./tests/explicit-skill-requests/run-test.sh team-review 你的提示词文件——单技能触发验证脚本它会跑真实会话并检查技能是否被触发。验证新会话里让代理列出技能team-review 应在列表中当同名个人技能存在时代理执行的是个人版本团队技能保持原样。 CI 里加一个技能触发验证目标技能没加载、或提示词不再触发技能时流水线直接失败而不是等合并后才发现。准备CI runner 上装好 Node.js 与对应代理 CLItests/claude-code 的测试要求 claude 命令可用并把仓库 checkout 到工作目录。操作在流水线里克隆仓库后执行# 1) 全量快速技能测试默认每测试 300 秒超时CI 放宽到 900 cd tests/claude-code ./run-skill-tests.sh --timeout 900 # 2) 单独验证某个技能能否被显式请求触发 cd ../.. ./tests/explicit-skill-requests/run-test.sh systematic-debugging \ tests/explicit-skill-requests/prompts/use-systematic-debugging.txtrun-skill-tests.sh——技能快速测试入口——退出码 0 即通过tests/claude-code/test-helpers.sh 里的 run_claude、assert_contains 等断言函数负责逐条校验。看 run-test.sh 的输出命中时打印 PASS: Skill ... was triggered并列出本次实际触发的全部技能。验证故意改坏某个 SKILL.md 的前置字段再跑一次对应测试应当 FAIL——这一步能证明你的验证真的在起作用。⚡ 避坑你大概率会踩的 4 个坑坑 1代理无视技能直接写代码现象新会话里代理不声明 Using ... 就开写。原因session-start 钩子没跑引导上下文没注入常见于手动拷贝文件而非走插件机制安装。解法opencode run --print-logs hello 21 | grep -i superpowers日志里没有 superpowers 就按插件机制重装。坑 2技能列表里少了某个技能现象代理列技能时缺一项。原因该目录缺 SKILL.md或 YAML 前置字段不合法缺 name/description 或 --- 未闭合。解法grep -r ^description: skills/ --includeSKILL.md正常应输出 14 行少一行就是哪个技能出了问题。坑 3更新后代理还是旧行为现象拉到新提交行为没变。原因基于 git 的插件规格会把解析到的版本钉在 lockfile 或缓存里重启后不一定拿到新提交。解法清掉 OpenCode 的包缓存或重新安装插件需要稳定时按 tag 钉住具体版本。坑 4内网合规检查到外部请求现象企业内网环境监控到出站流量。原因brainstorming 可视化伴侣的 logo 默认从官网加载会带上你本地的 Superpowers 版本号不含任何项目内容。解法export SUPERPOWERS_DISABLE_TELEMETRY1该变量设任意真值即关闭。进阶调优参数参数默认值建议值作用位置--timeout300 秒/测试CI 用 900tests/claude-code/run-skill-tests.shmax-turns3保持 3tests/explicit-skill-requests/run-test.sh钩子 matcherstartup|clear|compact保持默认hooks/hooks.jsonSUPERPOWERS_DISABLE_TELEMETRY未设置开启内网设为 1brainstorming 可视化伴侣插件版本规格main 分支按 tag 钉住OpenCode 的 opencode.json日常保持全部默认即可CI 里只调 --timeout内网环境关掉遥测其余参数动它之前先想清楚为什么。Superpowers 的设计目标是让这套工作流成为强制项而不是建议技能加载后代理在每次动作前自查流程就不会被跳过。完整的支持工具列表与安装方式见仓库 README.md测试架构概览见 docs/testing.md从个人到 CI剩下的就是按场景把对应的验证跑起来。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考