用途:维护技能与智能体文件中内联的共享协议块(SYNC: 块)。当共享协议清单变更时,把更新内容传播到所有相关技能;或向尚无该块的技能/智能体文件新增分层块。
主要能力:操作 A 更新已有 SYNC: 块内容——按指定标签或全部标签,从规范源 .claude/skills/shared/sync-inline-versions.md 提取内容,替换各技能中开闭标签之间的内容,并校验标签配对、内容一致、块外内容未被改动。操作 B 新增分层块——先编辑规范源,再在 .claude/scripts/sync-hooks-to-skills.py 的 BLOCKS、REMINDERS 及各层级列表中添加条目,先 --dry-run 再执行,最后用 grep 与回归套件验证。
使用方式:$sync-skills-shared-protocols <tag> 同步单个标签;all 同步全部;不带参数则交互询问。新增块走脚本驱动流程:python .claude/scripts/sync-hooks-to-skills.py --dry-run --verbose,确认后去掉 --dry-run 执行;可用 --agents-only 限定仅智能体。验证命令:grep -rl "SYNC:{tag}" .claude/skills/*/SKILL.md;回归测试:node .claude/hooks/tests/run-all-tests.cjs --filter=agent-universal。
适用场景:共享协议规则变更后的批量同步;新增协议块并分层下发到技能与智能体。
限制:必须先改规范源再运行;不得修改 SYNC 标签边界之外的内容;:reminder 块为手写,默认不同步;目标文件缺少闭合标签时跳过并报错;插入器只增不删,降级层级需手工移除多余块;技能专属块需同时在 AGENT_ADOPTION_EXEMPT 与 EXCLUDED_ORCHESTRATION 两处声明,二者无自动交叉校验;智能体必须且只能归入一个层级集合,否则脚本报错退出。具体文件数量与平台支持以实际仓库为准,资料未提供更多细节。