用途:在安装、删除、创建、移动或重命名技能后运行,为委派方生成最新技能索引。
主要能力:扫描用户与项目的已知技能目录中的 */SKILL.md;按需读取 frontmatter 提取名称与描述触发词;渲染 .atl/skill-registry.md,包含扫描来源、注册表契约、技能名、触发词/描述、作用域与精确路径;在可用时以 title: skill-registry、topic_key: skill-registry、type: config、capture_prompt: false 持久化到 Engram;返回注册表路径、技能数量、缓存状态及 Engram 是否更新。
硬性规则:注册表是指数而非编译器或摘要,SKILL.md 仍是唯一事实来源;默认不生成或注入压缩规则,向子代理传递精确技能路径以保留作者意图;无论 SDD 持久化模式如何,始终写入 .atl/skill-registry.md;跳过 sdd-*、_shared 和 skill-registry;按技能名去重,项目级优先于用户级;可能时将 .atl/ 加入 .gitignore,除非明确禁用。
决策门:同一技能同时存在于全局与项目时保留项目级;存在于多个全局位置时保留扫描顺序中的第一个来源;未找到技能时写入空注册表,使代理停止盲目搜索;代理将委派工作时,选择匹配的注册表行并传递其 SKILL.md 路径。
执行步骤:扫描所有已知用户与项目技能目录的 */SKILL.md;按需读取 frontmatter 提取名称与描述触发词;渲染 .atl/skill-registry.md;可用时持久化到 Engram;返回注册表路径、技能数量、缓存状态及 Engram 是否更新。
输出契约:返回项目名与 .atl/skill-registry.md 路径、已索引技能数量、缓存命中或已重新生成、以及相关跳过或重复技能。
参考:docs/skill-style-guide.md 说明索引前的技能编写方式;skills/_shared/skill-resolver.md 说明委派方如何使用索引。未提供收费、价格、平台或效果等信息。