Claude Code 技能深度揭秘：Superpowers 如何发现、加载并裁决你的技能？
Claude Code 技能深度揭秘Superpowers 如何发现、加载并裁决你的技能【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers你让 AI 写代码却无法让它按你的规矩来Superpowers 是一个 Claude Code 技能库把先头脑风暴再写码、先测试再交付这类开发方法论做成一个个技能以插件形式装进 Claude Code、Codex 等编码代理。可它凭什么知道该用哪个技能带你拆开看看这套 Claude Code 技能库的底层逻辑。系统是怎么扫描出你的技能的 先明确一个概念所谓技能就是一个独立目录一个技能一个文件夹里面必须有一份SKILL.md——它是技能的身份证没有它系统不认这个目录。技能发现机制类似文件查找器分三步lib/skills-core.js 中的findSkillsInDir递归遍历技能根目录默认skills/最深 3 层——既能覆盖brainstorming/scripts这类嵌套结构又不会无限下钻浪费开销。只要目录里出现SKILL.md就命中并登记为一个技能。extractFrontmatter解析文件顶部的元数据取出name和description两个字段。frontmatter前置元数据是什么就是 Markdown 文件开头用两行---夹起来的小段信息长这样--- name: brainstorming description: 任何创意工作开始前先做头脑风暴 ---name让系统能按名字调起技能description让模型自己判断当前任务适不适合用它。你写得越具体触发就越准。你说用一下 brainstorming背后依次发生了什么 ⚙️技能被调用时系统不会直接读文件而是走完四步路径解析。resolveSkillPath先把技能名换算成具体文件路径——这一步同时决定了加载谁的版本下一节细说。命名空间处理。名字带superpowers:前缀如superpowers:brainstorming时直奔官方技能目录不带前缀则先查个人目录。读取并剥离。读入完整SKILL.md剥掉 frontmatter只把正文注入对话上下文。资源随附。技能目录里的脚本和子文档如 skills/brainstorming/scripts/由模型按正文指引按需取用。打个比方frontmatter 是名片只在扫描时看一眼正文是员工手册真正干活时才翻开。所以哪怕库里躺着几十个技能上下文也不会被撑爆。官方技能和我的同名技能撞车了谁说了算 ⚖️Superpowers 内置遮蔽Shadowing机制相当于同名文件的就近覆盖两个同名技能都在路径上时离你近的那个生效。你的操作生效结果直接说brainstorming且有个人版加载你的个人版直接说brainstorming没有个人版自动回退到官方版明确说superpowers:brainstorming永远加载官方版个人技能放在个人目录Claude Code 下即~/.claude/skills官方技能在仓库的skills/。个人技能覆盖官方技能是刻意设计和平共存——官方库持续更新你的定制版不跟它打架逐步替换——可以一次只改一个官方技能不必整库照抄随时逃生——superpowers:前缀是官方版入口方便你试驾官方版本或对照调试定制版。上手清单写自己的技能安全覆盖官方 ✅动手前先把源码拿下来git clone https://gitcode.com/GitHub_Trending/su/superpowers然后三步走写技能。照 skills/ 下任一现有技能复制目录结构写一份SKILL.mdfrontmatter 里给全name和description措辞方法见 skills/writing-skills/SKILL.md。安全覆盖。同名个人版放进个人目录即可遮蔽官方技能不要直接改官方SKILL.md需要验证官方行为时用superpowers:前缀调用官方版对照。验证生效。改动后开新会话让模型列出可用技能——你的技能出现在列表里、描述正确就算装好了。三条建议每个技能的description只写一句具体话如在 X 之前使用覆盖官方技能时名字必须完全一致避免双重登记每次改完定制版都用superpowers:前缀跑一遍官方版做行为对照。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考