Skip to content

待定:为关键事实建立单一来源与引用规则 #1

@Counull

Description

@Counull

背景

在维护多层 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 反馈,不包含任何私有项目、公司业务、路径、需求文档或代码细节。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions