sync-agent-skills

用途

sync-agent-skills 用于在仓库根目录维护智能体技能目录的符号链接，使 .agents/skills/ 成为唯一权威来源。.claude/skills 与 .hermes/skills 均为指向 ../.agents/skills 的目录符号链接，因此在该处新增的技能对所有智能体可见，无需复制。该技能的作用就是重新创建这些链接。

主要能力

创建或修复 .claude/skills 符号链接。
在 .hermes/ 存在或传入 --hermes 时，同时管理 .hermes/skills。
仅检查漂移并以退出码 1 报告。
强制替换本应为符号链接的真实目录，将其移动为 .bak 备份而非删除。

使用方式

在仓库根目录运行：

.agents/skills/sync-agent-skills/scripts/sync.sh           # 创建或修复符号链接
.agents/skills/sync-agent-skills/scripts/sync.sh --check   # 仅报告漂移，若有则退出 1
.agents/skills/sync-agent-skills/scripts/sync.sh --force   # 用符号链接替换本应是链接的真实目录
.agents/skills/sync-agent-skills/scripts/sync.sh --hermes  # 在 .hermes/ 不存在时也管理 .hermes/skills

.claude/skills 始终被管理；.hermes/skills 仅在 .hermes/ 存在或传入 --hermes 时管理。

--force 会将冲突的真实目录移动为 <path>.bak，绝不删除。不加该选项时脚本会停止，以便先将该目录中的技能移入 .agents/skills/。

运行后

运行 --check，必须输出 already in sync。

仅在 .agents/skills/<name>/ 下创建技能，不要通过别名目录创建。

Hermes 还需要自身的配置才能发现 .agents/skills；仅靠符号链接无法完成该设置。

适用场景

适用于在仓库根目录集中管理多个智能体共享技能，并需要在添加、编辑或删除技能后重新同步链接的场景。

技能介绍

用途

主要能力

使用方式

运行后

适用场景

限制