assess-docs-ssot

Original：🇺🇸 English

Translated

Assess SSOT integrity with intent-first methodology and produce conflict matrix with canonical source mapping.

1installs

Sourcenesnilnehc/ai-cortex

Added on2026-04-26

NPX Install

npx skill4agent add nesnilnehc/ai-cortex assess-docs-ssot

SKILL.md Content

View Translation Comparison →

技能：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