registry-sync-validator

registry-sync-validator: Registry同步一致性检查

描述

审计 Registry 是否与设计 artifacts 保持一致，确保每个 artifact 都已正确注册并关键字段同步。Registry 是追溯链的基础基础设施，不一致会导致：

• CONSTRAINT 验收失败（Registry 同步是第 1 组结构性必须项）
• 追溯链断裂，后续 IMPLEMENTATION 阶段追溯困难
• 多人协作中 artifact 遗漏或重复注册

适用场景

• WORKFLOWSTEP4 Task S4-2 Round 2：生成所有 artifacts 后，第一次检查 Registry
• WORKFLOWSTEP4 Task S4-3：Self-Reflection 中定期审核 Registry 一致性
• WORKFLOWSTEP4 Task S4-5 前：准备进入 CONSTRAINT 验收前的最后检查
• 多人协作场景：确保团队成员都正确注册了各自的 artifacts

输入

• spec/design/ 目录（所有 VS/SD/DM/ARCH/ADR artifacts）
• Registry 文件（路径：.registry.json 或 _sys/registry.md 等）
• 当前级别（L2/L3）

输出

• Registry 同步检查报告（markdown）
• 同步率统计（如"95%，19/20 个 artifacts 已注册"）
• 遗漏清单：在 design/ 中存在但未在 Registry 中注册的 artifacts
• 冗余清单：在 Registry 中存在但在 design/ 中已删除的 artifacts
• 字段不一致清单：已注册但关键字段与实际 artifact 不同步
• 修复建议（按优先级排序）

执行策略

1. 扫描 design/ 目录，提取所有 artifacts：

- VS-<SN>-NNN（Value Stream） - SD-<SN>-NNN（Sequence Diagram） - DM-<SN>-NNN（Data Model） - ARCH-<SN>-NNN（Architecture） - ADR-<SN>-NNN（Architecture Decision Record，L3 only）

1. 解析 Registry，提取已注册的 artifacts 清单和关键字段：

- name（artifact 名称） - id（unique ID） - level（L1/L2/L3） - stage（REQUIREMENTS/DESIGN/IMPLEMENTATION） - status（active/deprecated）

1. 对比分析：

- 遗漏注册：在 design/ 中存在但不在 Registry 中 - 冗余注册：在 Registry 中但在 design/ 中已删除 - 字段不一致：关键字段（name/level/stage）与 design/ 中的 artifact 不一致

1. 生成报告：

- 同步率统计（% 数值） - 遗漏清单（按 artifact 类型分类） - 冗余清单 - 字段不一致清单 - 优先级修复建议（Critical: 遗漏 > High: 字段不一致 > Medium: 冗余）

1. 验收标准：

- L2：同步率 ≥95%（最多 1 个遗漏） - L3：同步率 ≥99%（无遗漏，允许冗余但应标注为 deprecated）

价值

• SPEC 组织：确保 Registry 准确性，是 CONSTRAINT 第 1 组验收的必要条件
• 质量报告：Registry 是追溯链的基础，准确性直接影响 CRAFT/CONSTRAINT 验收报告
• DevOps/工具链：Registry 用于生成各类自动化报告（覆盖率、追溯链等），准确性至关重要
• 多人协作：快速发现谁的 artifacts 没有注册或注册错误

验收标准（CONSTRAINT 第 1 组结构性）