正在打开每日关注
正在打开每日关注
倡议在全局 AGENTS.md 中要求交付物只呈现最终状态，避免文档和代码修改残留过程噪音。
最近在全局的 AGENTS.md 里加了这么一条： # Deliverables - Write deliverables as self-contained final-state artifacts. Incorporate feedback directly without mentioning drafts, versions, review rounds, prior wording, superseded decisions, or the editing process unless the user explicitly requests a changelog, history, or decision record. 实在受不了 AI 改代码，尤其是文档时，总喜欢留下各种“V1、V2、V3 的结论已被推翻，最新结论巴拉巴拉”之类的过程噪音。
是什么 这是一条面向编码 Agent 的全局交付规范：要求最终产物自洽、可独立阅读，并把反馈直接吸收进成稿；除非用户明确要求变更记录，否则不展示草稿、版本号、被推翻的表述或编辑过程。推文的出发点是对 AI 修改代码、尤其是维护文档时留下“V1/V2/V3 结论演变”感到厌烦。
核心设计 它把“过程”和“交付”分离：上下文可以服务于 Agent 的推理，但输出应只保留当前有效事实。规则还给出了明确的例外条件，避免把真正需要历史追踪的 changelog、决策记录一并抹掉。其价值不在新增功能，而在通过一条高层约束统一多个任务的输出形态。
关键洞察 最终态文档更适合作为团队知识、项目说明和后续 Agent 输入，能降低读者辨认“哪个结论有效”的成本，也减少旧信息被再次引用的机会。对代码交付而言，同样有助于让说明与当前实现保持一致。它提示我们：Agent 指令不仅要规定做什么，也要规定交付物应呈现怎样的状态。
边界与风险 “只写最终态”不等于删除必要的依据、兼容性说明或决策背景；在审计、排障、合规和需要复盘的场景，历史信息仍应进入专门的记录。若规则执行过严，可能让读者失去理解取舍的线索。因此，最好把最终文档与 changelog、ADR 等历史载体分层，而不是在同一份正文中混写。