Superpowers 深度解析一次技能调用背后的发现、加载与优先级裁决【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers在 Claude Code 里敲下superpowers:brainstorming回车Agent 没有立刻写代码而是先追问你到底要做什么。这背后是 Superpowers——一个 Claude Code 技能库。它靠递归目录扫描发现技能靠路径解析加载技能并在同名技能出现时按固定规则裁决加载谁。下面从一次调用开始把这条链路拆开看。 一个技能被发现的完整路径发现的起点是一次目录递归扫描。系统从技能根目录出发逐层向下默认最大深度为 3 层足以覆盖扁平布局和两级嵌套又不会遍历整棵树。目录里必须有SKILL.md才算一个技能这是唯一标识个人技能与官方技能则放在不同命名空间里互不串扰。命中之后系统解析技能文件头部的 YAML frontmatter取出名字和描述--- name: brainstorming description: You MUST use this before any creative work... ---这两个字段让 Agent 知道它叫什么、什么时候该触发。仓库里十几个技能全部按此方式摆放见 skills 目录。 superpowers: 前缀用法加载时的三个角色找到技能只是第一步还要解析出真实路径。resolveSkillPath承担这件事而superpowers:前缀是用户能给出的唯一显式信号superpowers:brainstorming它起三个作用显式指向官方带前缀强制加载官方技能跳过个人目录裸名默认个人优先不带前缀时先找个人命名空间缺失自动回退个人版本不存在时静默回退官方技能不报错。整个流程就是先查个人命名空间再查官方命名空间最后读取SKILL.md交给 Agent。⚖️ 个人技能覆盖官方技能的三条裁决规则技能遮蔽Shadowing是这套优先级机制的核心同名个人技能会直接遮蔽官方技能。类比一下——它很像本地.env文件覆盖全局配置不做合并就近者生效。场景实际加载个人与官方同名都存在个人技能只有官方存在官方技能显式superpowers:前缀官方技能三条规则可记成默认个人优先、前缀强制官方、缺失自动回退。两类技能和平共存你可以逐个把自己的版本替换上去做渐进式升级官方新版也不会把你的改动冲掉。改完随时用checkForUpdates检查更新配合 Git 还能随时回滚某一处覆盖。️ 两个真实技能强制前置与两阶段评审强制前置brainstorming机制最终要落到具体技能上。brainstorming 的 description 声明它必须在任何创意工作前使用正文还设了一道硬门槛设计呈现并获用户批准之前禁止写代码、禁止搭脚手架。只是加个小配置也不例外这正是它被自动触发时最有价值的地方。两阶段评审子代理驱动开发subagent-driven-development 则管执行阶段做法是每个任务派一个全新子代理实现上下文互相隔离每完成一个任务先做任务级评审规范符合度 代码质量全部任务结束后再对整条分支做一次宽范围评审。分工加两级把关长任务执行几小时也不容易跑偏。 日常维护命名、文档与更新检查每个技能都是独立目录新增或替换某个技能不影响其他部分这是模块化带来的直接红利目录结构清晰也让协作审查成本低。日常维护记住三条命名用短横线连接的英文如writing-plans每个目录的 SKILL.md 保持完整——frontmatter 与正文步骤缺一不可否则 Agent 无法正确触发定期用checkForUpdates检查技能库更新有更新时通过 Git 拉取并先审查变更再升级。设计取舍记录在 设计文档目录。想彻底吃透这些机制最快的办法是复制一个现有技能目录、改名、重写 SKILL.md完整走一遍发现 → 加载 → 裁决的链路。【免费下载链接】superpowersAn agentic skills framework software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考