SuperAPI AI 工具集

skill-registry

智能体与模型

查看项目

更新于 10-15 21:50

技能介绍

用途:生成或更新技能注册表,即所有可用技能的目录,并附带精简规则(5-15 行摘要)。委派智能体读取后把匹配的精简规则直接注入子智能体提示;子智能体不读取注册表,也不读取单个 SKILL.md。这是技能解析协议的基础,注册表构建一次(成本高),之后每次委派读取成本低。

运行时机:安装或移除技能后、新项目初始化后、用户明确要求更新注册表时,以及作为 sdd-init 的一部分。

主要步骤:一,扫描所有已知技能目录中的 /SKILL.md,用户级包括 ~/.claude/skills/、~/.config/opencode/skills/、~/.gemini/skills/、~/.cursor/skills/、~/.copilot/skills/ 及本技能文件的父目录;项目级包括 {project-root}/.claude/skills/、{project-root}/.gemini/skills/、{project-root}/.agent/skills/、{project-root}/skills/。跳过 sdd-、_shared 和 skill-registry;同名技能去重保留项目级。提取 name、description 中的 trigger、精简规则,形成 Trigger | Skill Name | Full Path 表。二,生成每个技能 5-15 行的精简规则,只含可执行规则、约束、关键模式和易错点,不含动机、使用时机、完整代码示例或安装步骤,格式为 ### {skill-name} 加项目符号列表。三,扫描项目根目录约定文件:agents.md/AGENTS.md、项目级 CLAUDE.md、.cursorrules、GEMINI.md、copilot-instructions.md;若发现索引文件需读取并提取其中引用的所有路径一并记录。四,写入注册表 markdown,包含 User Skills 表、Compact Rules 段和 Project Conventions 表。五,持久化:必须先在项目根创建 .atl/ 目录并写入 .atl/skill-registry.md;若 engram 可用,再以 mem_save 保存(title 与 topic_key 均为 skill-registry,type 为 config)。六,返回摘要,列出项目名、位置、engram 状态、找到的用户技能与项目约定。

限制:精简规则必须每技能 5-15 行;无论 SDD 持久化模式如何都要写 .atl/skill-registry.md;无技能或约定时写空注册表;若存在 .gitignore 且未列出 .atl,应将其加入。