Superpowers 技能发现与优先级机制一次调用背后的完整链路【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是一个 Claude Code 技能库解决的是编码助手接到任务就上手写代码的问题——它让助手先按既定流程走而不是直接开写。下面跟着一次完整调用把 Superpowers 技能加载机制从头走到尾。 技能从哪来一次只下探三层的目录扫描系统启动后做的第一件事是技能发现。入口在lib/skills-core.js的findSkillsInDir它递归扫描技能目录默认最多下探 3 层。限制深度不是为了抠性能而是划边界一个技能就是一个自包含的目录里面有SKILL.md才算数文档、脚本、参考资料都跟着这个目录走不往外依赖。再深的层级只会制造噪音。每个SKILL.md开头是一段YAML frontmatter就两个字段name: brainstorming description: You MUST use this before any creative work...extractFrontmatter负责解析它。别小看 description 这一句——它就是助手判断该不该用这个技能的触发依据写得好不好直接决定这个技能会不会被调起来。你说头脑风暴一下系统怎么定位到文件发现只是建了索引真正加载靠resolveSkillPath。传进来的技能名可能带前缀比如superpowers:brainstorming。处理规则其实就两条名字带superpowers:前缀 → 去掉前缀直接去官方技能目录找不带前缀 → 先去个人技能目录找找到后返回文件路径和来源类型剩下就是把这个SKILL.md的内容交给助手当上下文照着走。⚡ 两个技能同名谁说了算个人目录优先官方兜底。这套规则有个名字叫技能遮蔽Shadowing只要个人目录里存在同名的SKILL.md加载的就是它官方版原地不动。这套规则乍看简单但实际设计确实花了不少心思。想把某个官方技能改成自己的版本拷一份到个人目录改就行官方仓库一行不用动也不影响其他技能——改哪个遮蔽哪个可以逐个推进。哪天个人版删掉了自动回退到官方版不会出现技能凭空消失的空窗。另外技能库本身是个 Git 仓库系统用checkForUpdates检查是否落后于远端更新官方技能时不会碰你的个人版本两套东西互不干扰。执行时发生了什么想自己写一个该放哪执行阶段没有魔法加载到的SKILL.md变成上下文助手照着流程推进。skills/brainstorming/里的技能靠前文那种 frontmatter 描述保证创意工作前必须先调用skills/subagent-driven-development/则展示复杂流程怎么拆——每个任务交给独立子代理执行配上两阶段评审。想自己写一个成本比想象中低在个人技能目录下建个目录放一份写全的SKILL.md就够了。命名沿用短横线分隔的英文风格和现有技能保持一致方便检索也不会撞奇怪的名字。写完即生效名字撞上官方版本时还会自动遮蔽它。扩展点就是目录本身不需要注册没有额外配置。【免费下载链接】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 是一个 Claude Code 技能库解决的是编码助手接到任务就上手写代码的问题——它让助手先按既定流程走而不是直接开写。下面跟着一次完整调用把 Superpowers 技能加载机制从头走到尾。 技能从哪来一次只下探三层的目录扫描系统启动后做的第一件事是技能发现。入口在lib/skills-core.js的findSkillsInDir它递归扫描技能目录默认最多下探 3 层。限制深度不是为了抠性能而是划边界一个技能就是一个自包含的目录里面有SKILL.md才算数文档、脚本、参考资料都跟着这个目录走不往外依赖。再深的层级只会制造噪音。每个SKILL.md开头是一段YAML frontmatter就两个字段name: brainstorming description: You MUST use this before any creative work...extractFrontmatter负责解析它。别小看 description 这一句——它就是助手判断该不该用这个技能的触发依据写得好不好直接决定这个技能会不会被调起来。你说头脑风暴一下系统怎么定位到文件发现只是建了索引真正加载靠resolveSkillPath。传进来的技能名可能带前缀比如superpowers:brainstorming。处理规则其实就两条名字带superpowers:前缀 → 去掉前缀直接去官方技能目录找不带前缀 → 先去个人技能目录找找到后返回文件路径和来源类型剩下就是把这个SKILL.md的内容交给助手当上下文照着走。⚡ 两个技能同名谁说了算个人目录优先官方兜底。这套规则有个名字叫技能遮蔽Shadowing只要个人目录里存在同名的SKILL.md加载的就是它官方版原地不动。这套规则乍看简单但实际设计确实花了不少心思。想把某个官方技能改成自己的版本拷一份到个人目录改就行官方仓库一行不用动也不影响其他技能——改哪个遮蔽哪个可以逐个推进。哪天个人版删掉了自动回退到官方版不会出现技能凭空消失的空窗。另外技能库本身是个 Git 仓库系统用checkForUpdates检查是否落后于远端更新官方技能时不会碰你的个人版本两套东西互不干扰。执行时发生了什么想自己写一个该放哪执行阶段没有魔法加载到的SKILL.md变成上下文助手照着流程推进。skills/brainstorming/里的技能靠前文那种 frontmatter 描述保证创意工作前必须先调用skills/subagent-driven-development/则展示复杂流程怎么拆——每个任务交给独立子代理执行配上两阶段评审。想自己写一个成本比想象中低在个人技能目录下建个目录放一份写全的SKILL.md就够了。命名沿用短横线分隔的英文风格和现有技能保持一致方便检索也不会撞奇怪的名字。写完即生效名字撞上官方版本时还会自动遮蔽它。扩展点就是目录本身不需要注册没有额外配置。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考