registry-sync-validator: Registry同步一致性检查
描述
审计 Registry 是否与设计 artifacts 保持一致,确保每个 artifact 都已正确注册并关键字段同步。Registry 是追溯链的基础基础设施,不一致会导致:
- CONSTRAINT 验收失败(Registry 同步是第 1 组结构性必须项)
- 追溯链断裂,后续 IMPLEMENTATION 阶段追溯困难
- 多人协作中 artifact 遗漏或重复注册
适用场景
- WORKFLOW_STEP_4 Task S4-2 Round 2:生成所有 artifacts 后,第一次检查 Registry
- WORKFLOW_STEP_4 Task S4-3:Self-Reflection 中定期审核 Registry 一致性
- WORKFLOW_STEP_4 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 不同步
- 修复建议(按优先级排序)
执行策略
-
扫描 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)
-
解析 Registry,提取已注册的 artifacts 清单和关键字段:
- name(artifact 名称)
- id(unique ID)
- level(L1/L2/L3)
- stage(REQUIREMENTS/DESIGN/IMPLEMENTATION)
- status(active/deprecated)
-
对比分析:
- 遗漏注册:在 design/ 中存在但不在 Registry 中
- 冗余注册:在 Registry 中但在 design/ 中已删除
- 字段不一致:关键字段(name/level/stage)与 design/ 中的 artifact 不一致
-
生成报告:
- 同步率统计(% 数值)
- 遗漏清单(按 artifact 类型分类)
- 冗余清单
- 字段不一致清单
- 优先级修复建议(Critical: 遗漏 > High: 字段不一致 > Medium: 冗余)
-
验收标准:
- L2:同步率 ≥95%(最多 1 个遗漏)
- L3:同步率 ≥99%(无遗漏,允许冗余但应标注为 deprecated)
价值
- SPEC 组织:确保 Registry 准确性,是 CONSTRAINT 第 1 组验收的必要条件
- 质量报告:Registry 是追溯链的基础,准确性直接影响 CRAFT/CONSTRAINT 验收报告
- DevOps/工具链:Registry 用于生成各类自动化报告(覆盖率、追溯链等),准确性至关重要
- 多人协作:快速发现谁的 artifacts 没有注册或注册错误
验收标准(CONSTRAINT 第 1 组结构性)
| 级别 | Registry 同步率 | 遗漏容忍度 | 字段不一致容忍度 | |------|----------------|----------|-----------------| | L2 | ≥95% | 最多 1 个 | 0 个(必须修复) | | L3 | ≥99% | 0 个 | 0 个(必须修复) |