技能:SSOT 完整性评估(Assess Docs SSOT)
目的 (Purpose)
发现文档之间的语义重叠与冲突,建立 canonical source 与修复动作,降低重复与不一致风险。
核心目标(Core Objective)
首要目标:输出可执行 SSOT 审计报告(Intent Registry + Conflict Matrix + Repair Plan)。
成功标准:
- ✅ 已完成意图建模(path_layer/artifact_type/ownership/granularity/section_intents)
- ✅ 已完成候选对筛选与冲突判定
- ✅ 已产出带优先级的冲突矩阵
- ✅ 每个 P0/P1/P2 冲突都有 canonical source 与 repair action
- ✅ 已写入
docs/calibration/ssot-integrity-audit.md
范围边界(Scope Boundaries)
本技能负责:SSOT 语义冲突审计。 本技能不负责:核心合规评分、链接图检查、代码文档对齐。
使用场景(Use Cases)
- full 治理审计
- 多目录文档重构前冲突排查
行为(Behavior)
阶段 0:Norms Resolution(v1.1 新增)
按 specs/artifact-contract.md §8 Runtime Norms Resolution Protocol 的 §8.2 / §8.3 / §8.5 实现:读项目规范若声明了 ssot-integrity-audit artifact_type 的 path_pattern,则使用项目值;否则 fall through 到技能默认(docs/calibration/ssot-integrity-audit.md)。本技能为固定路径治理产出,只用 path_pattern 覆盖机制。
阶段 1:SSOT 评估
- 意图建模(Intent Registry)
- 候选对筛选(意图重叠 + 粒度相近)
- 分层相似度分析(section/doc/entity)
- 冲突分级(P0/P1/P2/Info)
- 输出 canonical mapping 与修复清单
输入与输出 (Input & Output)
输入
- docs 范围
- 可选冲突阈值
- 可选重点层
输出
docs/calibration/ssot-integrity-audit.md
限制(Restrictions)
- 仅输出审计报告,不自动合并文档
- 不自动删除或移动文件
自检(Self-Check)
- Intent Registry 完整
- Conflict Matrix 完整
- 每个冲突含 canonical source + repair action
- 报告已落盘
示例(Examples)
- 两份 roadmap 文档里里程碑日期冲突 -> P0