ssot-content-management

单一事实源与变更管理（SSOT Content Management）

核心思想

让内容尽量"声明式"：事实库管文号/数值，内容库管表达，发布层管渲染。改东西只动源头，不改下游。

源自 MedXpert 知识库项目实战（2026-08-16 复盘）：需求看似多变，70% 的返工源于"机制前置不足"而非需求本身变化。

三层架构

事实库（Fact Source）    ← 唯一真相：法规文号/周期/费用/定义/版本号，变化只改这里
    ↓ 引用（不复制数值）
内容库（Content Source） ← 表达层：FAQ/文章/案例/说明书，引用事实库，不自行写死数值
    ↓ 脚本/技能自动生成
发布层（Publish Layer）  ← 官网 HTML/公众号排版/PDF/标书，由内容库渲染，不手改

落地步骤（任何项目）

1. 识别可变事实：列出内容中所有"会变化的事实"（文号、周期、费用、版本、名称、数字）
2. 建事实库：一张表/一个文件，单点维护。示例字段：名称 | 文号 | 生效日期 | 状态 | 核实来源 | 核实日期
3. 内容引用规范化：内容中优先引用"条文/概念"而非"文号/数值"（如"依据条例关于备案的规定"），文号只存在于事实库
4. 发布自动化：内容库 → 发布层用脚本/技能生成，杜绝手动搬运
5. 变更影响清单：预先写出"改 A 要动 B/C"，每次变更按清单走，不遗漏

复盘模板（减少反复的三问）

每次项目结束/需求反复后自问：

一句话原则：先立机制、再定结构、最后填内容。

事实库通用模板（Markdown）

# {项目名} 事实库（Single Source of Truth）

> 最后核实：{日期} ｜ 来源均为一手官方渠道

## 一、核心事实

| 名称 | 文号/数值 | 生效日期 | 状态 | 备注 |
|---|---|---|---|---|
| ... | ... | ... | ✅ 现行 | ... |

## 二、变更记录

| 日期 | 变化内容 |
|---|---|
| ... | ... |

## 三、核实来源

- {官方来源 1}
- {官方来源 2}

使用规则

• 内容文件不直接写文号来源，引用事实库
• 法规/事实变化时：① 只改事实库 → ② 检查受影响内容 → ③ 改内容库 → ④ 重新生成发布层
• 每次核实更新"最后核实"日期并记录变化
• 对外发布内容走流程：查事实库 → 生成 → 人工复核 → 发布

已应用案例

• MedXpert 官网内容源：乐享 = 内容库，法规文号事实库.md = 事实库，sync_lexiang_website.py = 渲染层。改 FAQ 答案 2 步（乐享→同步）；法规变化只改事实库
• 可推广场景：公众号运营（数据/案例事实库+模板）、质量体系文档（标准文号事实库+程序模板）、产品文档（版本/功能事实库）、投标文件（资质证书事实库）、培训材料（知识点事实库）

版权与许可

© 2026 SynomosAI（版权持有）。署名 诺源@SynomosAI 原创。按 MIT 协议开源（详见 LICENSE.md）。 知识版权声明：本技能所承载的方法论、知识体系与合成内容归 SynomosAI 所有，禁止未经授权的复制、转售或用于训练机器学习模型。

免责声明：本技能按「现状」（AS IS）提供，不作任何明示或暗示担保，使用后果由使用者自负。不构成法律、医疗、财务或监管建议；涉及合规事项请另行咨询专业机构。