企业官网建设流程全解析

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

它起三个作用：

1. 显式指向官方：带前缀强制加载官方技能，跳过个人目录；
2. 裸名默认个人优先：不带前缀时，先找个人命名空间；
3. 缺失自动回退：个人版本不存在时静默回退官方技能，不报错。

整个流程就是：先查个人命名空间，再查官方命名空间，最后读取SKILL.md交给 Agent。

⚖️ 个人技能覆盖官方技能的三条裁决规则

技能遮蔽（Shadowing）是这套优先级机制的核心：同名个人技能会直接遮蔽官方技能。类比一下——它很像本地.env文件覆盖全局配置，不做合并，就近者生效。

三条规则可记成：默认个人优先、前缀强制官方、缺失自动回退。两类技能和平共存，你可以逐个把自己的版本替换上去做渐进式升级，官方新版也不会把你的改动冲掉。改完随时用checkForUpdates检查更新，配合 Git 还能随时回滚某一处覆盖。

🛠️ 两个真实技能：强制前置与两阶段评审

🧪强制前置：brainstorming

机制最终要落到具体技能上。brainstorming 的 description 声明它必须在任何创意工作前使用，正文还设了一道硬门槛：设计呈现并获用户批准之前，禁止写代码、禁止搭脚手架。"只是加个小配置"也不例外，这正是它被自动触发时最有价值的地方。

🤖两阶段评审：子代理驱动开发

subagent-driven-development 则管执行阶段，做法是：

• 每个任务派一个全新子代理实现，上下文互相隔离；
• 每完成一个任务，先做任务级评审（规范符合度 + 代码质量）；
• 全部任务结束后，再对整条分支做一次宽范围评审。

分工加两级把关，长任务执行几小时也不容易跑偏。

📦 日常维护：命名、文档与更新检查

每个技能都是独立目录，新增或替换某个技能不影响其他部分，这是模块化带来的直接红利；目录结构清晰，也让协作审查成本低。日常维护记住三条：

1. 命名用短横线连接的英文，如writing-plans；
2. 每个目录的 SKILL.md 保持完整——frontmatter 与正文步骤缺一不可，否则 Agent 无法正确触发；
3. 定期用checkForUpdates检查技能库更新，有更新时通过 Git 拉取并先审查变更再升级。

设计取舍记录在 设计文档目录。想彻底吃透这些机制，最快的办法是复制一个现有技能目录、改名、重写 SKILL.md，完整走一遍"发现 → 加载 → 裁决"的链路。

【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers