用途:当某个技能对一个或多个智能体不可见、技能在 ~/.hermes/ 与 .claude/ 之间迁移后、向工作区新增仓库时,或执行 hermes update、harness-update 后需要确认配置未损坏时使用。
主要能力:按智能体统计技能数量(Claude Code 使用原生 .claude/skills/,Codex CLI 与 Gemini CLI 通过符号链接指向 .claude/skills/,Hermes 通过 ~/.hermes/config.yaml 中的 external_dirs 读取);验证 .codex/skills 与 .gemini/skills 是否为符号链接而非真实目录;检查各仓库(如 CAD-DEVELOPMENTS、digitalmodel、worldenergydata、achantas-data、assetutilities 等)的 per-repo 符号链接目标;检查 external_dirs 覆盖情况;查找仅存于 ~/.hermes/skills/ 未迁移的技能。
使用方式:审计步骤用 find -L 统计 SKILL.md(需排除 /_archive/,否则符号链接目录会返回 0),用 test -L 判断符号链接。修复包括:将 .codex/skills 真实目录替换为 ln -s ../.claude/skills .codex/skills;为仓库补齐 ln -s ../../.claude/skills .codex/skills 与 .gemini 链接;在 ~/.hermes/config.yaml 的 skills.external_dirs 中补充缺失仓库路径后运行 scripts/_core/sync-agent-configs.sh;用 bash scripts/hermes/backfill-skills-to-repo.sh --commit 迁移本地技能。
限制与注意:不加 -L 的 find 不跟随符号链接,统计会得到 0;.codex/skills 可能因 git checkout 解引用符号链接被真实目录取代;子仓库内的 Codex/Gemini 仅能看到本仓库 .claude/skills,不会自动看到 workspace-hub 的规范技能(设计如此以限制上下文预算);工作区路径变更需更新 config/agents/hermes/config.yaml.template 中的 WS_HUB_PATH 并重新同步;_archive 下约 2166 个归档技能不应计入。具体技能数量、路径与命令以实际资料为准。