用途:维护技能文件中以 <!-- SYNC:tag --> 包裹的共享协议内联块。当共享协议清单变更时,把规范内容传播到所有技能;或把新增协议块批量插入到尚未包含它的技能/智能体文件。
主要能力:操作 A 更新已有 SYNC: 块内容,可按指定标签或全部标签同步;操作 B 通过脚本向全部技能/智能体文件批量插入新块。规范来源为 .claude/skills/shared/sync-inline-versions.md。
使用方式:操作 A 先读取规范文件,用 grep -rl "SYNC:{tag-name}" .claude/skills/*/SKILL.md 查找目标文件,替换开闭标签之间的内容,并校验标签配对与内容一致。操作 B 先在规范文件新增 ## SYNC:{new-block-name} 段,再在 .claude/scripts/sync-hooks-to-skills.py 的 BLOCKS、REMINDERS、BLOCK_ORDER 中登记,先运行 python .claude/scripts/sync-hooks-to-skills.py --dry-run --verbose 验证,再正式运行。调用示例:$sync-protocols understand-code-first、$sync-protocols all。
适用场景:共享协议规则变更后的跨技能传播,以及无钩子环境下的协议回退同步。
限制:必须先编辑规范文件再同步;不得修改 SYNC 边界之外的内容;:reminder 块为手写,默认不同步;目标文件缺少闭合标签时跳过并报错;批量插入必须用脚本,不得手工处理全部文件。内联协议属有意重复,不应抽取为文件引用。