source-consumer-sync

name	source-consumer-sync
description	真相源-消费者同步规范 — 为规范源、模板、validate、文档站与部署副本变更建立 Concept Sync Map，区分当前消费者与历史镜像

Source Consumer Sync Skill

职责

当任务会修改 instructions、skills、prompts、validate、README、website、Profile 或部署副本口径时，本 Skill 负责建立 Concept Sync Map，明确：

• 哪个文件是当前真相源
• 哪些文件是当前消费者，必须同批同步
• 哪些文件只是历史镜像，可以在满足条件时保留
• 哪些 validate probes、targeted tests 与部署副本必须一起更新

触发条件

场景	是否触发
控制面 / 规范源 / 模板 / validate / 报告模板变更	🔴 必须
README / website / Profile 当前行为说明变更	🔴 必须
部署副本同步口径变更	🔴 必须
仅局部业务代码改动	N/A

Concept Sync Map

字段	必填	说明
sourceOfTruth	✅	当前事实源，例如 instructions.md、某个 Skill、某个 prompt 或脚本
currentConsumers	✅	当前会被用户、runtime、validate 或部署副本实际消费的文件
historicalMirrors	条件	仅作归档/历史基线的文件，允许保留旧事实但必须明确历史性质
validateProbes	✅	validate 编号、targeted tests 或其他自动化探针
deployCopies	条件	.github/、.claude/、AGENTS.md、.agents/、.codex/ 等需要同步的副本
yellowDeviationBoundary	✅	哪些新增当前消费者/探针可以按黄色偏离收口，而不需要回 CP2

分类规则

当前消费者

满足任一条件即视为当前消费者，本轮必须同步：

• 当前 README / website / guide / Profile 正在描述现行行为
• validate / targeted tests 直接依赖该描述或字段
• 部署副本会把该内容发给实际宿主
• 报告模板、实施模板会在下一轮继续消费该字段

历史镜像

仅在以下条件同时满足时，才可作为历史镜像暂不改动：

1. 文档已明确标注历史版本/基线/归档。
2. 页面不再以“当前行为”口吻描述现状。
3. 本轮 validate 或 targeted tests 不把它当作当前消费者。

执行步骤

1. 锁定本轮 sourceOfTruth。
2. 建立 currentConsumers / historicalMirrors 清单。
3. 为当前消费者补齐 validateProbes 和必要 targeted tests。
4. 列出 deployCopies：用户级全局 adapter 可建议 devcodex global-adapters apply（或 npm -g / pack 路径），但必须把全局环境修改作为独立授权动作；workspace .devcodex 才使用 bare devcodex update。ConceptSyncMap、Auto、Profile 或 stale 状态不授予任一部署 mutation。
5. 定义 yellowDeviationBoundary，把允许纳入的额外消费者写入进度或报告。
6. 实施后做双向联查：正向 grep 真相源，反向 grep 旧口径残留。

能力面新增或变化时，Concept Sync Map 必须把 skills/spec-governance/capability-surface-decision.v1.schema.json 与任务目录 capability-surface-decisions/*.json 作为中央 schema/record 真相源，记录 decisionRef + schemaDigest。Owner Skills、Prompt、TestRoute、report、public docs、Profile 和部署副本只能作为 readers/consumers；任何消费者复制中央选择字段、出现第二 writer，或 decision identity 已失效时均阻断同步。

部署副本同步还必须执行物理所有权复核：以 target root 下规范化绝对 destination 为键，而不是只按 surface 名称去重。同一路径出现多个 current writer/manifest entry 时阻断；宿主专用 adapter 可以位于项目内，但不得被公共 bridge 描述为所有宿主的共享消费者。

Registry 驱动的同步面

规范吸纳、控制面或历史规则分层时，不在本 Skill 维护版本号清单。执行方必须读取 ../spec-governance/gate-registry.json，用 gateGroup 找到 ownerSkills / requiredEvidence / route / legacyAnchors，再建立本轮 Concept Sync Map。

每个适用分组至少核对：

1. 规范真相源与目标 Owner Skill。
2. Prompt/template、TestRoute、report schema 等当前执行消费者。
3. validate/targeted/negative fixture 等验证探针。
4. README、website、Profile 和 changelog 等公开消费者。
5. AGENTS、CLAUDE、Copilot、Codex、plugin package 等部署副本。
6. 历史镜像及其失效、保留或兼容边界。
7. 能力面任务的 decisionRef / schemaDigest / writer / readers 是否仍与中央记录一致。

跨仓消费者验证、Profile/宿主能力、修复协作、发布凭据、用户文档、派生消费者与返工闭环等专属字段由 registry 指向的 Owner Skill 定义。本 Skill 只保存关系、同步状态和偏离原因，不复制 Owner 的完整门禁正文。

历史 V73~V95 名称只作为 registry legacyAnchors 的检索入口；新增版本不得继续扩展本文件的版本专属长列表。

黄色偏离边界

以下情况可按黄色偏离处理，但必须记录到实施进度或报告：

• 为同一事实新增一个当前消费者或一个 validate probe
• 因部署同步需要追加一个当前副本检查点
• 为避免“真相源已修、当前消费者未修”补同步少量当前页面

以下情况不是黄色偏离：

• 新增另一套真相源
• 把当前页面降格为历史镜像但未明确标注
• 扩大到大批历史归档翻修

输出格式

## ConceptSyncMap

| 字段 | 内容 |
|------|------|
| sourceOfTruth | |
| currentConsumers | |
| historicalMirrors | |
| validateProbes | |
| deployCopies | |
| yellowDeviationBoundary | |

与其他 Skill 的关系

• spec-governance：SCV-1 的核心输入来自本 Skill 的 Concept Sync Map。
• execution-contract：通过 consumerScope 和 deviationLog 约束同步边界。
• document-sync：实施后根据 Concept Sync Map 判断 README / website / Profile / changelog 等是否必须同步。
• report：控制面任务报告中需显式列出 Concept Sync Map、黄色偏离和部署同步证据。