knowledge

知识

知识记录是认知归属——用于记录项目所相信、选择、疑惑、观察到或受约束的内容，是有类型且可引用的实体。 记录会塑造工作；它们本身绝不是工作项。

四种归属，一条路径：工作意图 → 待办事项；认知状态 → 知识 记录；架构决策 → ADR；Agent 指引 → 记忆。参见 lib:reference/using-doctrine.md § 哪种记录适合放在哪里。

CLI 是准确标志和各类型状态词汇的事实来源： doctrine knowledge --help。

类型选择

表述形式	类型
“暂按 X 处理”（未经验证的前提）	assumption（ASM）
“我们选择了 X，而非 Y”（有范围或操作层面的选择）	decision（DEC）
“尚未解决——X？”（需要答案）	question（QUE）
“受 X 约束”（外部施加的限制）	constraint（CON）
“观察到——X”（可引用的观察）	evidence（EVD）
“可检验的主张 X”（等待证据）	hypothesis（HYP）
“稳定的心智模型／术语 X”	concept（CPT）

DEC 还是 ADR？ 对整个项目都适用且会带来架构影响的决策 → doctrine adr new；有范围或操作层面的决策 → DEC。

动词

查看 doctrine knowledge --help（以及 doctrine link --help / doctrine supersede --help），了解动词列表和标志。使用 shapes 将记录链接到其 所塑造的工作（对于由它引发的工作，使用 spawns）；证据关系边使用 supports 或 disputes。

放错位置了？

• 工作意图（错误／改进／杂务／风险／想法）→ /backlog。
• 可复用的 Agent 指引、操作方法或注意事项 → /record-memory。

区分标准：知识记录是关系图中的可引用认知实体——可建立关联、可设门控、可被取代；记忆是面向 Agent 的检索层指引。同样的区分也适用于 CPT 和记忆中的 concept：CPT 为其他实体会引用的稳定项目概念命名；记忆则解释如何思考或工作。

门控——关联不等于门控

关于知识记录的门控机制（needs，解决后解除阻塞），参见 lib:reference/using-doctrine.md § 哪种记录适合放在哪里。

规则

• 查看 doctrine knowledge show --help——读取和转换时，ID 前缀会解析出类型。
• 创建记录时，会采用该类型的默认状态（held、proposed、open、active 等）。
• 不要手动编辑记录 TOML（lib:reference/using-doctrine.md § 存储 层级）——请使用相应动词；正文（*.md）可手动编辑。