nesnilnehc/assess-docs-ssot
skills/assess-docs-ssot/SKILL.md
Assess SSOT integrity with intent-first methodology and produce conflict matrix with canonical source mapping.
$ install --global
skillsauthnpx skillsauth add nesnilnehc/ai-cortex assess-docs-ssotInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 29, 2026, 9:49 AM12.0s3 files scanned
SKILL.md
- name:
- assess-docs-ssot
- description:
- SSOT integrity audit report with intent registry and conflict matrix
- description_zh:
- 采用意图优先方法评估 SSOT 完整性，输出冲突矩阵与 canonical source 映射。
- tags:
- [documentation, workflow, governance, ssot]
- version:
- 1.1.0
- license:
- MIT
- recommended_scope:
- project
- author:
- ai-cortex
- triggers:
- [ssot audit, docs ssot, intent conflict]
- type:
- document-artifact
- artifact_type:
- ssot-integrity-audit
- path_pattern:
- docs/calibration/ssot-integrity-audit.md
- lifecycle:
- living
技能：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
附录：输出合约 (Appendix: Output Contract)
本技能产出 SSOT Integrity Audit：
| 元素 | 格式 | 必填字段 | 路径模式 |
| :--- | :--- | :--- | :--- |
| 报告主体 | Markdown | front-matter；章节：意图分类 / 冲突矩阵 / 权威源映射 / 修复建议 | docs/calibration/ssot-integrity-audit.md |
| 冲突矩阵 | 表格 | concept / canonical_source / divergent_sources / conflict_kind（duplicate / contradiction / drift） | 「冲突矩阵」节 |
| 权威源映射 | 表格 | concept / canonical_path / superseded_paths / handoff_skill | 「权威源映射」节 |
| 机器可读块 | YAML fenced yaml ssot_conflicts: | concepts[] 每项含 name/canonical/divergents/severity | 报告末尾 |
Related Skills
nesnilnehc/scaffold-agent-tests
development
VerifiedTrustedCommunity
Generate an LLM agent test suite (golden cases, mock-LLM unit tests, evaluator harness) from an agent implementation and its agent-test contract. Use when an agent has no tests, or a contract exists but the test code is missing.
7SKILL.mdUpdated May 30, 2026
nesnilnehc/redeploy-local
development
VerifiedTrustedCommunity
After code changes, auto-detect the project's build system and local deployment method for a given directory, then build the project and restart its locally-deployed environment (Docker Compose / systemd / process manager). Never assumes — asks only when detection is ambiguous. Caches detected commands per project in .cortex/redeploy-local.yaml; re-invocations on the same project skip re-scanning until signal files change, the cache expires (30 days), or the skill version bumps.
7SKILL.mdUpdated May 22, 2026
nesnilnehc/publish-nats-message
tools
VerifiedTrustedCommunity
Publish a NATS message conforming to a cross-team contract, using NATS MCP tools. Authors the contract on first use if missing. Reads project-level cache (.cortex/nats.yaml) to avoid re-prompting basics across sessions.
7SKILL.mdUpdated May 22, 2026
nesnilnehc/consume-nats-message
tools
VerifiedTrustedCommunity
Drain pending NATS messages from a producer contract via NATS MCP tools (default batch / drain-style). Applies Tolerant Reader semantics and per-message ack/nak/term, returning aggregated stats. Reads project-level cache (.cortex/nats.yaml) to avoid re-prompting.
7SKILL.mdUpdated May 22, 2026