| name | record-skill-dependency |
| description | 在创建、安装或同步用户自维护全局 Skill 后,或用户主动安装外部 Skill 后,维护 GLOBAL/SKILL_DEPENDENCIES.md。用户要求记录 Skill 依赖、更新 SKILL_DEPENDENCIES.md、安装外部 Skill 后登记、新增全局 Skill 后登记,或维护 GLOBAL/SKILL_DEPENDENCIES.md 时使用。不要用于默认预装 Skill、系统 Skill、插件提供的 Skill、插件缓存 Skill 或临时运行文件。 |
记录 Skill 依赖
使用这个 Skill 在新增、安装或同步全局 Skill 后,维护 GLOBAL/SKILL_DEPENDENCIES.md。
核心规则
源稿位于 {{AGENT_ROOT}}\GLOBAL\.agents\skills\ 的自维护全局 Skill 必须记录,并保持源稿、用户级安装副本和依赖清单一致。
外部 Skill 只记录用户主动安装、且迁移或重装环境时需要主动恢复的条目。
外部 Skill 如果缺少配套 CLI、桌面应用、运行时、系统能力或授权就无法工作,必须同时记录该运行依赖、恢复步骤和最小验证命令;不能只记录 SKILL.md 的安装方式。
记录:
- 用户自己维护、并需要跨项目全局使用的 Skill。
- 用户主动从外部来源安装的 Skill。
- 依赖某个外部仓库、插件或手动步骤才能恢复的 Skill。
- 对长期工作流有稳定影响,换电脑时必须主动恢复的 Skill。
不记录:
- 默认预装 Skill。
- 系统 Skill。
- 插件随安装自动提供的 Skill。
- 插件缓存路径中的 Skill。
- 项目专属 Skill。
- 当前会话或运行时临时产物。
工作流程
- 判断本次对象是 GLOBAL 自维护 Skill、主动安装的外部 Skill、项目专属 Skill,还是默认/插件/缓存/临时内容。
- 如果是默认预装、系统、插件提供、插件缓存、项目专属 Skill 或临时产物,说明原因并停止,不要污染依赖清单。
- 如果是 GLOBAL 自维护 Skill,必须记录或更新。
- 如果是用户主动安装的外部 Skill,确认它是否需要迁移或重装时主动恢复;需要则记录,不需要则说明原因并停止。
- 判断该 Skill 是否依赖额外 CLI、应用、运行时、系统能力或授权;存在必需依赖时,记录恢复步骤和不产生业务写入的最小验证命令。
- 读取
GLOBAL/SKILL_DEPENDENCIES.md。
- 判断应该写入哪个章节:
GLOBAL 自维护 Skill:源稿在 {{AGENT_ROOT}}\GLOBAL\.agents\skills\ 的个人全局 Skill。
主动安装的外部 Skill:用户从外部来源主动安装、但源稿不由 GLOBAL 维护的 Skill。
- 如果条目已存在,更新恢复方式、来源、运行依赖或用途;不要重复添加。
- 如果
主动安装的外部 Skill 当前为“暂无。”,新增第一条外部 Skill 时移除“暂无。”。
- 保持条目简短、事实化,优先记录恢复所需信息,而不是复制 Skill 内容。
- 结束时说明记录到了哪个章节,以及是否跳过了默认预装/插件 Skill。
条目格式
GLOBAL 自维护 Skill:
### `skill-name`
- 源稿:`{{AGENT_ROOT}}\GLOBAL\.agents\skills\skill-name`
- 恢复方式:从 GLOBAL 源稿安装或同步到当前 Agent 可发现的全局 Skill 位置。
- 用途:一句话说明用途。
主动安装的外部 Skill:
### `skill-name`
- 来源:外部仓库、安装命令、插件或其他可恢复来源。
- 恢复方式:重新执行安装命令,或按来源说明恢复;安装到当前 Agent 可发现的全局 Skill 位置。
- 运行依赖:仅在缺少配套 CLI、应用、运行时、系统能力或授权会导致 Skill 不可用时记录,并附最小只读验证命令。
- 用途:一句话说明用途。
安全边界
不要复制系统 Skill、插件 Skill 或缓存目录内容到 GLOBAL。
不要递归移动、复制或删除 Junction / symlink 指向内容。
如果缺少来源、用途或恢复方式,先尽量从当前安装目录、用户说明或相关文档判断;仍不清楚时,只问必要问题。