背景
在维护多层 Markdown workflow 文档时,同一关键事实可能同时出现在总览、状态页、上下文页、操作指南和变更记录中。事实更新后需要多处同步修改,容易留下过期口径,也会增加维护成本。
待探索目标
建立一套“关键事实单一来源”的文档治理规则:关键事实只在一个规范位置完整陈述,其他文档尽量引用该事实源,只补充本页特有的影响或执行动作。
候选方向
- 为长期有效的事实、决策、约束建立 canonical fact / decision block,并提供稳定锚点或 ID。
- 派生文档避免重复完整陈述关键事实,改为引用 canonical source,并只写本页需要的局部结论。
- 在 workflow lint 中增加检查项:发现关键事实多处重复、状态口径冲突、派生页未引用事实源时给出提醒。
- 定义更新顺序:先更新事实源,再更新索引或派生页;派生页只在本地动作发生变化时修改。
- 区分“事实源”“解释/影响”“执行状态”“历史记录”,避免同一句事实散落到每个层级。
待定验收
- 明确哪些信息应进入 canonical fact / decision source。
- 明确派生页如何引用事实源,以及什么情况下允许重复摘录。
- 在
LLM_WORKFLOW.md 或配套 docs 中补充该规则。
- 在 workflow lint / publication scan 清单中增加重复事实和过期口径检查。
边界
本 issue 只记录通用 workflow 反馈,不包含任何私有项目、公司业务、路径、需求文档或代码细节。
背景
在维护多层 Markdown workflow 文档时,同一关键事实可能同时出现在总览、状态页、上下文页、操作指南和变更记录中。事实更新后需要多处同步修改,容易留下过期口径,也会增加维护成本。
待探索目标
建立一套“关键事实单一来源”的文档治理规则:关键事实只在一个规范位置完整陈述,其他文档尽量引用该事实源,只补充本页特有的影响或执行动作。
候选方向
待定验收
LLM_WORKFLOW.md或配套 docs 中补充该规则。边界
本 issue 只记录通用 workflow 反馈,不包含任何私有项目、公司业务、路径、需求文档或代码细节。