原理与概念
explanation/ 回答“是什么、为什么、如何理解”。它提供概念与理由,不单独规定接口、Schema 或验收。
阅读顺序
- OMK 如何理解知识:知识、实体、上下文与载体的概念基础。
- 为谁、解决什么:目标用户、任务及产品边界。
- 三阶段工作流:doctor、eval 与 observe 怎样协作。
- 架构:各领域的职责与依赖理由。
- 统计严谨性:如何理解证据、差异与结论限制。
- 同类工具与使用范围:按任务理解工具边界。
文档职责
| 要回答的问题 | 入口 |
|---|---|
| 是什么、为何这样设计 | 本目录;概念只定义一次 |
| 实现必须满足什么行为、边界和验收 | 领域规范;注明现行、部分交付 |
| 用户怎样完成任务 | 使用指南与 guides/ |
| 某字段、flag 或 API 怎么查 | reference/,如样本格式 |
同一篇文档可以引用其他职责的权威来源,但不复制一份会独立漂移的契约。维护规则见贡献指南。