# Prefab Governance Sync

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

- Skill: `eiway112/prefab-governance-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eiway112/prefab-governance-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eiway112/prefab-governance-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eiway112 (https://skillmd.com/u/eiway112)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eiway112/prefab-governance-sync

---


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

## 定位

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

## 三层结构与文件映射

| 层 | 路径 | 角色 |
|---|---|---|
| L1 开发源 | `D:\Qoder-Files\装配式装修技能开发\_专题_技能合集策划\` | 治理文件开发源；各 `_专题_*` 目录存子技能策划稿 |
| L2 运行时 SOT | `~/.qoder/skills/` | standards-index.md（根 SOT，头部含 SOT 声明+镜像说明）+ 各 prefab-*/skill-qa-tester 技能目录 |
| L3 只读镜像 | `~/.qoder/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:\Qoder-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 次即停 |