Case Study
从一份 Ontology 调研，到一套教学页面
原始材料有 1228 行。我把对象、关系、Action、权限和审计拆成九章，并做成中英文页面。
拆内容
先决定读者要学会什么
原文同时混着产品事实、自建架构、服装零售例子、伪代码和 AI 安全规则。照着原顺序压缩，读者还是很难学会。
原文里不能丢的事实
- Ontology 不是薄薄的 BI 语义层，而是可操作的业务层。
- 关键不是对象图本身，而是 Action、权限和审计。
- 服装系统里，下单只增加 reserved，发货时才减少 onHand。
- AI Agent 不应该直接写 SQL，只能走安全工具门。
- Palantir 只能作为参考案例，不能被写成采购推荐。
页面需要补的结构
- 用中文语境重写，而不是英文概念逐字翻译。
- 保留中英文切换，方便公开传播和国际读者理解。
- 用对象图、Action 流水线、迁移路线和错误修正板讲清知识。
- 让读者看完能自己设计一个轻量 Ontology-like 系统。
- 检查中英文、桌面和手机的实际排版。
制作过程
我把过程拆成五步
每一步都留下一个文件或检查结果，后面改页面时不用重新猜当时的判断。
01
Request Anchor
写清读者、目标、事实边界和必须保留的内容。
02
Content Model
把调研拆成九章：概念、积木、对象图、Action、实现、AI、迁移、错误和判断。
03
DESIGN.md
记录颜色、字体、页面结构和不能出现的供应商宣传口吻。
04
Critique / Repair
删口号，修长表格、代码块和手机端的换行。
05
Verification
中英文、桌面和手机都打开检查，再看一遍整页截图。
结果
完整页面
下面是最终页面的缩略图。完整版本可以单独打开。
项目文件
留下的文件
除了最终页面，项目里还保留了当时的内容拆解、设计规则和检查记录。
Contract
DESIGN.md
颜色、字体、页面结构和质量门。
Content
CONTENT.md
九章内容结构和不能丢的事实。
Critique
REVIEW.md
记录供应商口吻、手机端和间距问题。
Validation
Desktop + mobile
中英文页面的桌面和手机截图。
这些文件都留在项目里，后面继续改页面时，可以直接接着做。