prefab-governance-sync

name	prefab-governance-sync
description	装配式装修技能合集治理文件三层同步与发布流程（项目仓策划 ↔ 运行时 skills 根 SOT ↔ shared 只读镜像）。当用户要求同步治理文件、发布技能更新、同步 standards-index/glossary/interface-contracts/红线注册表、或发现三层文件不一致需要修复漂移时使用。变更定级与审批规则不在此技能，以 change-governance.md 为唯一事实源。
version	1.1.0

治理文件三层同步（prefab-governance-sync）

定位

装配式装修技能合集治理文件的执行层同步流水线（薄技能）：只管"怎么同步、怎么验收"。变更定级（S/A/B/C）、审批流程、专项规则的唯一事实源是 change-governance.md（项目仓 _专题_技能合集策划/ 与 shared/ 各一份，须保持同步）。

三层结构与文件映射

层	路径	角色
L1 开发源	D:\QoderWork-Files\_项目工作\装配式装修技能开发\_专题_技能合集策划\	治理文件开发源；各 _专题_* 目录存子技能策划稿
L2 运行时 SOT	~/.qoderwork/skills/	standards-index.md（根 SOT，头部含 SOT 声明+镜像说明）+ 各 prefab-*/skill-qa-tester 技能目录
L3 只读镜像	~/.qoderwork/skills/shared/	change-governance、glossary、interface-contracts、platform-adapter-reference、redlines-registry、standards-index、standards-reasoning-rules（头部为 shared 路径定位措辞）

特例：redlines-registry.md 运行时只有 shared/ 镜像一处（无根副本），LF 换行，同步 = 备份后字节覆盖。

同步前检查（必做）

1. 三方逐文件比对（项目仓 ↔ 运行时根 ↔ 镜像），用 cmp 或哈希，输出差异清单。
2. 读各冲突文件头部"最后更新"字段定方向：新的覆盖旧的，逐文件独立判定（允许不同文件方向不同，glossary 曾出现运行时反向更优的先例）。
3. 方向不明或两侧都有独有改动时，暂停，报告用户裁决，不得猜测合并。

标准变更五步同步（standards-index 类）

1. 修源文件（项目仓策划目录）
2. 更新 standards-index（含重编号）——重编号陷阱：§锚定表行内含 "| 序号 | 编号 |" 子串，须先替换锚定表行、再替换主表行，否则脚本断言冲突
3. 同步策划表（技能合集策划方案索引等 A0 表）
4. 同步映射文件（reasoning-rules 激活表、技能内序号引用）
5. grep 交叉验证：标准编号/序号全链零残留旧值

发布到运行时

• 覆盖前先备份：_pre 后缀（如 v2_1_2_pre）或 shared/backup_skills_shared_YYYYMMDD/ 目录。
• standards-index 根 ↔ 镜像同步：头部声明不同（根含 SOT+镜像说明两行，镜像为 shared 措辞）。字节覆盖后必须恢复各自头部声明，只同步正文。
• redlines-registry：备份 → 字节覆盖 → 确认 LF 换行（CRLF=0）。
• 子技能 SKILL.md 升版：改 frontmatter version + 对应变更说明；技能内容变更须按 change-governance.md 定级走复核。

脚本化同步流程（推荐路径）

批量同步（≥3 个文件）优先用脚本编排，避免手工逐文件复制遗漏：

1. 三方比对：对同步范围内文件计算哈希，输出差异清单（对应 GS-R-P2-1）
2. 备份：目标文件备份为 _pre 后缀或备份目录（对应 GS-R-P0-1）
3. 字节复制：按既定方向（L1 → 备份镜像 → 运行时）复制
4. 哈希/CRLF 校验：复制后逐文件 sha256 比对 + LF 约定文件 CRLF=0（对应 GS-R-P2-2）
5. CG/git 收尾：登记 CG 编号、提交信息含同步验证结论（对应 GS-R-P1-3/P2-3）

冲突检测（方向仲裁）：同步前哈希比对发现运行时与镜像彼此不一致（非单向落后于源）时，即判定方向不明，暂停并输出差异清单报用户裁决（对应 GS-R-P0-2）。

回滚：任一校验失败时，从步骤 2 的备份恢复全部目标文件，重新校验后方可继续。

并发控制：同步过程中发现目标文件哈希与同步前快照不一致（可能被其他任务修改），立即停止，不得继续覆盖。

验收清单

1. 三方比对：本次同步范围内所有文件哈希一致（头部声明差异除外，须显式声明）
2. CRLF 检查：同步后的 LF 约定文件 CRLF=0
3. grep 回归：变更涉及的编号/序号/标注（如"待官方核验"）全链零残留旧值
4. change-governance.md 变更日志已登记 CG 编号，项目仓与 shared 镜像两份一致
5. git 提交：项目仓提交，信息含 CG 编号与同步验证结论

git 提交与推送

• 提交在项目仓 D:\QoderWork-Files\_项目工作\装配式装修技能开发 执行，信息格式参照既有提交（CG 编号 + 内容摘要 + 同步验证结论）。
• 推送：GIT_TERMINAL_PROMPT=0 git -c credential.helper= -c credential.helper=manager push（读 Windows 凭据管理器）。
• GitHub 连接 reset 连败 2 次即停，本地提交安全，改日再推，不得无限重试。

接口契约（IC-13 接收方）

本技能作为治理同步工具的接收方，遵循接口契约 IC-13（任何技能 → GS 治理同步工具）。完整 Schema 见 ../shared/interface-contracts.md §4.4 IC-13。

请求参数（与 IC-13-Request Schema 字段集一致，Schema 为 additionalProperties:false）：

参数	必填	说明
同步文件清单	是	相对项目仓的文件路径列表
变更级别	是	按 change-governance.md 定级：S/A/B/C
CG编号	是	已登记的变更治理编号，格式 CG-YYYYMMDD-NNN
同步方向	否	缺省 L1 开发源→镜像；反向或跨方向须显式说明来源与目标

响应内容：

字段	说明
同步结果	成功 / 部分成功 / 失败（枚举）
验收证据	逐文件哈希一致清单（头部声明差异显式声明）、CRLF 检查、grep 零残留结果
备份位置	覆盖前 _pre 后缀文件或备份目录路径清单
未决事项	方向不明待裁决项、连败停止项（存在时必返回）

必填参数缺失（尤其 CG编号未登记）时，拒绝执行并返回缺失项（对应 GS-R-P1-3）。

红线约束（禁止行为）

以下为本技能已注册红线摘要（全局编号），完整定义以 ../shared/redlines-registry.md §十七为准：

编号	红线	摘要
GS-R-P0-1	严禁未备份即覆盖	覆盖任何运行时/镜像文件前必须完成备份
GS-R-P0-2	严禁同步方向不明时擅自合并	两侧都有独有改动时暂停报用户裁决，不得猜测合并
GS-R-P1-1	严禁改写历史草稿与过程报告	标注清除与修改只发生在活跃文件
GS-R-P1-2	严禁同步中顺手修改正文内容	同步只搬运不加工；内容问题另立变更任务
GS-R-P1-3	严禁绕过定级与登记	须按 change-governance.md 定级并登记 CG 编号后方可同步
GS-R-P1-4	严禁将本技能当作治理规则权威源	规则冲突时以 change-governance.md 为唯一事实源
GS-R-P2-1	必须同步前三方比对	逐文件比对输出差异清单，差异未清不得覆盖
GS-R-P2-2	必须同步后验收留证	哈希一致、CRLF=0、grep 零残留并留证
GS-R-P2-3	必须登记提交信息并控制重试	提交信息含 CG 编号；推送 reset 连败 2 次即停