Back to Details

assess-docs-ssot

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

技能：SSOT 完整性评估（Assess Docs SSOT）

技能：SSOT 完整性评估（Assess Docs SSOT）

目的 (Purpose)

目的 (Purpose)

发现文档之间的语义重叠与冲突，建立 canonical source 与修复动作，降低重复与不一致风险。
发现文档之间的语义重叠与冲突，建立 canonical source 与修复动作，降低重复与不一致风险。

核心目标（Core Objective）

核心目标（Core Objective）

首要目标：输出可执行 SSOT 审计报告（Intent Registry + Conflict Matrix + Repair Plan）。
成功标准：
  1. ✅ 已完成意图建模（path_layer/artifact_type/ownership/granularity/section_intents）
  2. ✅ 已完成候选对筛选与冲突判定
  3. ✅ 已产出带优先级的冲突矩阵
  4. ✅ 每个 P0/P1/P2 冲突都有 canonical source 与 repair action
  5. ✅ 已写入 
    docs/calibration/ssot-integrity-audit.md
首要目标：输出可执行 SSOT 审计报告（Intent Registry + Conflict Matrix + Repair Plan）。
成功标准：
  1. ✅ 已完成意图建模（path_layer/artifact_type/ownership/granularity/section_intents）
  2. ✅ 已完成候选对筛选与冲突判定
  3. ✅ 已产出带优先级的 Conflict Matrix
  4. ✅ 每个 P0/P1/P2 冲突都有 canonical source 与 repair action
  5. ✅ 已写入 
    docs/calibration/ssot-integrity-audit.md

范围边界（Scope Boundaries）

范围边界（Scope Boundaries）

本技能负责：SSOT 语义冲突审计。 本技能不负责：核心合规评分、链接图检查、代码文档对齐。
本技能负责：SSOT 语义冲突审计。 本技能不负责：核心合规评分、链接图检查、代码文档对齐。

使用场景（Use Cases）

使用场景（Use Cases）

  • full 治理审计
  • 多目录文档重构前冲突排查
  • 全量治理审计
  • 多目录文档重构前冲突排查

行为（Behavior）

行为（Behavior）

阶段 0：Norms Resolution（v1.1 新增）

阶段 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 覆盖机制。
按 specs/artifact-contract.md §8 Runtime Norms Resolution Protocol 的 §8.2 / §8.3 / §8.5 实现：读取项目规范，若声明了 
ssot-integrity-audit
artifact_type 的 
path_pattern
，则使用项目配置值；否则默认使用技能预设路径（
docs/calibration/ssot-integrity-audit.md
）。本技能为固定路径治理产出，仅采用 path_pattern 覆盖机制。

阶段 1：SSOT 评估

阶段 1：SSOT 评估

  1. 意图建模（Intent Registry）
  2. 候选对筛选（意图重叠 + 粒度相近）
  3. 分层相似度分析（section/doc/entity）
  4. 冲突分级（P0/P1/P2/Info）
  5. 输出 canonical mapping 与修复清单
  1. 意图建模（Intent Registry）
  2. 候选对筛选（意图重叠 + 粒度相近）
  3. 分层相似度分析（section/doc/entity）
  4. 冲突分级（P0/P1/P2/Info）
  5. 输出 canonical mapping 与修复清单

输入与输出 (Input & Output)

输入与输出 (Input & Output)

输入

输入

  • docs 范围
  • 可选冲突阈值
  • 可选重点层
  • docs 范围
  • 可选冲突阈值
  • 可选重点层

输出

输出

  • docs/calibration/ssot-integrity-audit.md
  • docs/calibration/ssot-integrity-audit.md

限制（Restrictions）

限制（Restrictions）

  • 仅输出审计报告，不自动合并文档
  • 不自动删除或移动文件
  • 仅输出审计报告，不自动合并文档
  • 不自动删除或移动文件

自检（Self-Check）

自检（Self-Check）

  • Intent Registry 完整
  • Conflict Matrix 完整
  • 每个冲突含 canonical source + repair action
  • 报告已落盘
  • Intent Registry 完整
  • Conflict Matrix 完整
  • 每个冲突含 canonical source + repair action
  • 报告已落盘

示例（Examples）

示例（Examples）

  • 两份 roadmap 文档里里程碑日期冲突 -> P0
  • 两份 roadmap 文档里里程碑日期冲突 -> P0