Superpowers 技能库多场景实战指南从单次验证到团队规模化管理【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 技能库是一个面向编码智能体的技能框架与开发方法论装上之后你的 Agent 不再一上来就写代码而是先问清楚你要做什么、写出规格说明、拆好计划再派子代理逐个执行。基础安装完成后大家最关心的往往是三件事怎么确认它真的在工作、怎么改成自己想要的行为、团队推广后如何不失控。这篇 Superpowers 技能库实战指南就按这个顺序来。先把技能库跑起来一条命令验证加载装完立即验证的三步把仓库拉下来后先跑 tests/ 下的环境准备脚本tests/opencode/setup.sh它会在临时目录里搭一套隔离的测试环境不会污染你本机的真实配置。然后用一行 node 命令调用findSkillsInDir去扫描skills/目录git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers bash tests/opencode/setup.sh node -e const core require(./lib/skills-core); console.log(core.findSkillsInDir(./skills,superpowers))findSkillsInDir会递归找到每个技能目录里的SKILL.md解析开头的 YAML 元数据name 和 description建立索引。预期输出是一份技能清单且数量不少于 12 项、没有报错堆栈就说明技能发现这条链路是通的。前提环境Node.js v18、Git 2.30。会话启动钩子到底做了什么装好之后你不用敲任何特殊命令。每次开发会话启动时hooks/ 里的session-start钩子会读入using-superpowers这份总入口技能并注入到 Agent 上下文Agent 从第一条消息起就知道自己有超能力、该在什么时机去调用哪个技能。这就是为什么参考文档里强调它是一套自动触发的方法论而不是靠你手动喊话。第一次定制用个人技能覆盖系统技能优先级其实就是先找离你最近的规则技能库的路由由resolveSkillPath完成规则很直白系统先找你个人目录里有没有同名技能有就用你的没有才回落到基础技能库项目级技能优先级最高。想本地魔改某个行为比如给 brainstorming 加一条团队规范只需把改过的版本放到~/.superpowers-skills/对应子目录下Agent 会自动就近取材仓库本身一行不用动。用 superpowers: 前缀强制回基础库如果你不确定个人版本改没改对可以在调用时给技能名加上superpowers:前缀系统会跳过个人目录直接取基础库里的原版方便新旧对比。反过来排查为什么我的定制没生效时第一个该怀疑的就是个人技能目录名或SKILL.md文件名没对齐。把技能验证接进测试与 CI 流水线用内置脚本做回归tests/ 下按平台分了目录claude-code、codex、opencode、kimi 等每个平台都有独立的run-tests.sh。日常改动技能文案后跑一遍对应平台的回归脚本就能确认技能触发逻辑没被改坏。像 brainstorming、writing-plans、subagent-driven-development 这类核心技能的触发语义比较敏感尤其建议每次都跑。CI 里加一道技能校验团队协作时可以把技能触发回归塞进流水线的一个 stage拉取仓库、执行tests/下对应平台的回归脚本通过后再把skills/**/*.md打快照归档。这样技能文案被随手一改的改动就必须先过测试才合得进去。常见失败原因技能加载失败与优先级冲突技能列表为空或不全 ⚠️症状是findSkillsInDir返回空数组或明显缺项。两步排查先看ls -la skills/确认每个SKILL.md权限不低于 644、目录可进入再跑grep -r ^--- skills/检查每个技能文件的 YAML 前置元数据分隔符是否完整——缺了开头的---元数据就解析不出来这个技能就会从索引里消失。仍不行就运行 tests/opencode/ 下的诊断脚本拿详细错误报告。个人技能没生效先确认个人目录路径真的传给了运行时再确认子目录名与技能名完全一致。急着用官方版时直接用superpowers:前缀绕过个人目录是最快的止血办法。规模化落地参数调优与技能编写规范三个最值得调的参数技能数量超过 50 个后目录扫描会开始拖慢会话启动下面三个参数值得按需调整参数默认值建议取值作用说明maxDepth3个人环境 2团队环境 4控制递归扫描目录的深度cacheTTL3600 秒开发机 60CI/生产 86400技能索引缓存的过期时间timeout3000 毫秒网络差的环境调到 5000更新检查的等待上限合理调整后加载耗时通常能降 40% 左右代价只是缓存策略要自己把关。给团队定几条编写规范写新技能时守住三条底线SKILL.md必须带 name 和 description 元数据正文按何时触发—执行步骤—输出要求组织每个技能在 tests/ 对应 prompts 目录下至少留 2 个触发用例。做到这三点回归脚本才有东西可测规模化管理才不是空话 。小结Superpowers 技能库的价值不在装上了而在能验证、能定制、能收敛先用findSkillsInDir一行命令确认加载再用个人目录做低成本定制最后把触发回归接进 CI 并定好编写规范。 给你三条立即可做的动作今天就跑一次加载验证把你最常改的那个技能挪进个人目录试一次覆盖在下周迭代前给 CI 加上技能回归 stage。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Superpowers 技能库多场景实战指南：从单次验证到团队规模化管理
Superpowers 技能库多场景实战指南从单次验证到团队规模化管理【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 技能库是一个面向编码智能体的技能框架与开发方法论装上之后你的 Agent 不再一上来就写代码而是先问清楚你要做什么、写出规格说明、拆好计划再派子代理逐个执行。基础安装完成后大家最关心的往往是三件事怎么确认它真的在工作、怎么改成自己想要的行为、团队推广后如何不失控。这篇 Superpowers 技能库实战指南就按这个顺序来。先把技能库跑起来一条命令验证加载装完立即验证的三步把仓库拉下来后先跑 tests/ 下的环境准备脚本tests/opencode/setup.sh它会在临时目录里搭一套隔离的测试环境不会污染你本机的真实配置。然后用一行 node 命令调用findSkillsInDir去扫描skills/目录git clone https://gitcode.com/GitHub_Trending/su/superpowers cd superpowers bash tests/opencode/setup.sh node -e const core require(./lib/skills-core); console.log(core.findSkillsInDir(./skills,superpowers))findSkillsInDir会递归找到每个技能目录里的SKILL.md解析开头的 YAML 元数据name 和 description建立索引。预期输出是一份技能清单且数量不少于 12 项、没有报错堆栈就说明技能发现这条链路是通的。前提环境Node.js v18、Git 2.30。会话启动钩子到底做了什么装好之后你不用敲任何特殊命令。每次开发会话启动时hooks/ 里的session-start钩子会读入using-superpowers这份总入口技能并注入到 Agent 上下文Agent 从第一条消息起就知道自己有超能力、该在什么时机去调用哪个技能。这就是为什么参考文档里强调它是一套自动触发的方法论而不是靠你手动喊话。第一次定制用个人技能覆盖系统技能优先级其实就是先找离你最近的规则技能库的路由由resolveSkillPath完成规则很直白系统先找你个人目录里有没有同名技能有就用你的没有才回落到基础技能库项目级技能优先级最高。想本地魔改某个行为比如给 brainstorming 加一条团队规范只需把改过的版本放到~/.superpowers-skills/对应子目录下Agent 会自动就近取材仓库本身一行不用动。用 superpowers: 前缀强制回基础库如果你不确定个人版本改没改对可以在调用时给技能名加上superpowers:前缀系统会跳过个人目录直接取基础库里的原版方便新旧对比。反过来排查为什么我的定制没生效时第一个该怀疑的就是个人技能目录名或SKILL.md文件名没对齐。把技能验证接进测试与 CI 流水线用内置脚本做回归tests/ 下按平台分了目录claude-code、codex、opencode、kimi 等每个平台都有独立的run-tests.sh。日常改动技能文案后跑一遍对应平台的回归脚本就能确认技能触发逻辑没被改坏。像 brainstorming、writing-plans、subagent-driven-development 这类核心技能的触发语义比较敏感尤其建议每次都跑。CI 里加一道技能校验团队协作时可以把技能触发回归塞进流水线的一个 stage拉取仓库、执行tests/下对应平台的回归脚本通过后再把skills/**/*.md打快照归档。这样技能文案被随手一改的改动就必须先过测试才合得进去。常见失败原因技能加载失败与优先级冲突技能列表为空或不全 ⚠️症状是findSkillsInDir返回空数组或明显缺项。两步排查先看ls -la skills/确认每个SKILL.md权限不低于 644、目录可进入再跑grep -r ^--- skills/检查每个技能文件的 YAML 前置元数据分隔符是否完整——缺了开头的---元数据就解析不出来这个技能就会从索引里消失。仍不行就运行 tests/opencode/ 下的诊断脚本拿详细错误报告。个人技能没生效先确认个人目录路径真的传给了运行时再确认子目录名与技能名完全一致。急着用官方版时直接用superpowers:前缀绕过个人目录是最快的止血办法。规模化落地参数调优与技能编写规范三个最值得调的参数技能数量超过 50 个后目录扫描会开始拖慢会话启动下面三个参数值得按需调整参数默认值建议取值作用说明maxDepth3个人环境 2团队环境 4控制递归扫描目录的深度cacheTTL3600 秒开发机 60CI/生产 86400技能索引缓存的过期时间timeout3000 毫秒网络差的环境调到 5000更新检查的等待上限合理调整后加载耗时通常能降 40% 左右代价只是缓存策略要自己把关。给团队定几条编写规范写新技能时守住三条底线SKILL.md必须带 name 和 description 元数据正文按何时触发—执行步骤—输出要求组织每个技能在 tests/ 对应 prompts 目录下至少留 2 个触发用例。做到这三点回归脚本才有东西可测规模化管理才不是空话 。小结Superpowers 技能库的价值不在装上了而在能验证、能定制、能收敛先用findSkillsInDir一行命令确认加载再用个人目录做低成本定制最后把触发回归接进 CI 并定好编写规范。 给你三条立即可做的动作今天就跑一次加载验证把你最常改的那个技能挪进个人目录试一次覆盖在下周迭代前给 CI 加上技能回归 stage。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考