3分钟看懂 Superpowers 技能加载规则同名技能为什么会被覆盖【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是面向 Claude Code 等编码助手的技能扩展库它会自动扫描目录发现技能、按名字加载技能并在个人技能与官方技能同名时让个人版本优先。下面按技能从哪里来 → 谁被选中 → 怎么验证和保持更新的顺序讲清楚这套规则方便你在技能行为不符合预期时快速定位原因。从一个常见疑问开始为什么我写的技能没生效先说两个真实场景。你照着官方示例自己写了一个技能放进个人目录结果助手的行为完全没变或者你刚更新了技能库助手却还在用旧逻辑。两种情况的根子都一样技能加载存在一条隐式的选择顺序名字相同不代表谁都能赢。Superpowers 的做法很确定会话启动时它分别扫描官方技能库和你的个人技能目录把所有合法技能登记在册之后每次按名调用时都按同一套固定规则挑选。没有随机性所以只要理解规则你就能提前预判这次加载的是哪一份。怎样确认一个目录会被识别为有效技能Superpowers 识别技能的标准非常简单一个目录要成为技能需要满足三件事技能独立成目录目录里可以放脚本、参考文档等配套资源目录内必须有一份SKILL.md它是技能的门牌缺少这个文件的目录会被直接忽略SKILL.md开头用 YAML frontmatter 声明元数据至少包含名称name和描述description两项其中描述不是摆设。助手是否在当前场景触发某个技能主要就靠读这段描述。以官方的 brainstorming 技能为例它的描述直接写明在进行任何创意工作前必须使用于是设计阶段一进来就会被调用。描述写得越具体触发越可靠。一份标准的 frontmatter 长这样name: brainstorming description: Use before any creative work...想看看规范写法可以直接浏览仓库里 skills/ 目录下的各个技能。同名技能谁先被选中个人版与官方版的关系当助手决定按名字加载某个技能时选择顺序是固定的先看个人技能目录——存在同名技能就直接采用个人版本调用时带superpowers:前缀例如superpowers:brainstorming则强制加载官方版本个人版本被跳过个人目录没有同名技能时回退到官方库中查找这套个人覆盖官方的设计意味着你不必二选一。可以先把官方技能库原样用上再对自己不满意的单个技能逐步做定制版本其他技能仍保持官方最新状态互不干扰。如何验证当前生效的是哪个版本行为对不上预期时别猜直接确认来源借助技能列表能力例如 OpenCode 环境下的 find_skills 工具可以看到每个技能所属的命名空间和所在目录带superpowers:前缀的条目来自官方库不带前缀的来自个人目录同名单元同时存在时实际生效的一定是个人那份一句话判断法调用时加superpowers:前缀拿到的就是官方版不加前缀且个人目录有同名技能拿到的就是个人版。怎样让 Superpowers 技能库保持更新技能库本身是一个 Git 仓库项目内置了更新检查机制会话开始后会在后台静默拉取远程状态发现远端有新版就提示你整个过程不打断正在进行的工作也不自动改动你本地的文件。如果是自己克隆的仓库更新更直接克隆地址为https://gitcode.com/GitHub_Trending/su/superpowers之后在仓库目录里定期执行git pull即可。建议养成先检查更新、再排查问题的习惯很多行为奇怪其实是版本落后导致的。技能没生效时的排查清单按下面顺序过一遍能覆盖绝大多数没触发、行为不符的问题技能目录名是否拼写正确目录里是否存在SKILL.mdfrontmatter 是否同时包含名称和描述两个字段个人目录里是否恰好有同名技能——有则官方版永远轮不到想用官方版时调用名是否加上了superpowers:前缀技能库版本是否过旧更新检查是否提示过新版掌握这条识别 → 选择 → 验证的主线后Superpowers 的技能系统就不再是黑盒每一次加载都能被解释每一处覆盖都能被控制。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 3分钟看懂 Superpowers 技能加载规则：同名技能为什么会被覆盖
3分钟看懂 Superpowers 技能加载规则同名技能为什么会被覆盖【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowersSuperpowers 是面向 Claude Code 等编码助手的技能扩展库它会自动扫描目录发现技能、按名字加载技能并在个人技能与官方技能同名时让个人版本优先。下面按技能从哪里来 → 谁被选中 → 怎么验证和保持更新的顺序讲清楚这套规则方便你在技能行为不符合预期时快速定位原因。从一个常见疑问开始为什么我写的技能没生效先说两个真实场景。你照着官方示例自己写了一个技能放进个人目录结果助手的行为完全没变或者你刚更新了技能库助手却还在用旧逻辑。两种情况的根子都一样技能加载存在一条隐式的选择顺序名字相同不代表谁都能赢。Superpowers 的做法很确定会话启动时它分别扫描官方技能库和你的个人技能目录把所有合法技能登记在册之后每次按名调用时都按同一套固定规则挑选。没有随机性所以只要理解规则你就能提前预判这次加载的是哪一份。怎样确认一个目录会被识别为有效技能Superpowers 识别技能的标准非常简单一个目录要成为技能需要满足三件事技能独立成目录目录里可以放脚本、参考文档等配套资源目录内必须有一份SKILL.md它是技能的门牌缺少这个文件的目录会被直接忽略SKILL.md开头用 YAML frontmatter 声明元数据至少包含名称name和描述description两项其中描述不是摆设。助手是否在当前场景触发某个技能主要就靠读这段描述。以官方的 brainstorming 技能为例它的描述直接写明在进行任何创意工作前必须使用于是设计阶段一进来就会被调用。描述写得越具体触发越可靠。一份标准的 frontmatter 长这样name: brainstorming description: Use before any creative work...想看看规范写法可以直接浏览仓库里 skills/ 目录下的各个技能。同名技能谁先被选中个人版与官方版的关系当助手决定按名字加载某个技能时选择顺序是固定的先看个人技能目录——存在同名技能就直接采用个人版本调用时带superpowers:前缀例如superpowers:brainstorming则强制加载官方版本个人版本被跳过个人目录没有同名技能时回退到官方库中查找这套个人覆盖官方的设计意味着你不必二选一。可以先把官方技能库原样用上再对自己不满意的单个技能逐步做定制版本其他技能仍保持官方最新状态互不干扰。如何验证当前生效的是哪个版本行为对不上预期时别猜直接确认来源借助技能列表能力例如 OpenCode 环境下的 find_skills 工具可以看到每个技能所属的命名空间和所在目录带superpowers:前缀的条目来自官方库不带前缀的来自个人目录同名单元同时存在时实际生效的一定是个人那份一句话判断法调用时加superpowers:前缀拿到的就是官方版不加前缀且个人目录有同名技能拿到的就是个人版。怎样让 Superpowers 技能库保持更新技能库本身是一个 Git 仓库项目内置了更新检查机制会话开始后会在后台静默拉取远程状态发现远端有新版就提示你整个过程不打断正在进行的工作也不自动改动你本地的文件。如果是自己克隆的仓库更新更直接克隆地址为https://gitcode.com/GitHub_Trending/su/superpowers之后在仓库目录里定期执行git pull即可。建议养成先检查更新、再排查问题的习惯很多行为奇怪其实是版本落后导致的。技能没生效时的排查清单按下面顺序过一遍能覆盖绝大多数没触发、行为不符的问题技能目录名是否拼写正确目录里是否存在SKILL.mdfrontmatter 是否同时包含名称和描述两个字段个人目录里是否恰好有同名技能——有则官方版永远轮不到想用官方版时调用名是否加上了superpowers:前缀技能库版本是否过旧更新检查是否提示过新版掌握这条识别 → 选择 → 验证的主线后Superpowers 的技能系统就不再是黑盒每一次加载都能被解释每一处覆盖都能被控制。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考