保留粒度取决于文档将来被谁、为什么目的调用。如果后续还要接手维护,保留到能独立复现一次决策即可;如果只用于内部对账或责任确认,保留到能说明结论和依据即可。粒度不是越细越安全,过度保留会提高检索成本,让真正有用的记录被淹没。
这两种用途对粒度的要求不同,判断错方向会导致要么无法接手,要么文档臃肿。
给执行者用的文档,目标是让一个没参与项目的人能继续操作。它需要保留:改了哪些页面或配置、改动前后的对照、判断依据、以及未完成事项。粒度到“某个具体动作对应哪条依据”就够,不需要保留每一次中间讨论。
给审计者用的文档,目标是回答“当时为什么这么做、谁批准的”。它需要保留:决策结论、决策时间、批准人、以及支撑结论的那份数据快照。粒度到“结论加一份可核对来源”即可,不必保留全部原始导出。
如果两类读者都存在,不要合并成一份超长文档,而是分成结论层和操作层两层。结论层放决策与依据,操作层放可复现步骤,两层用同一个项目编号关联。这样执行者不必翻审批记录,审计者也不必读操作细节。
这种情况下,历史文档的主要价值是防止知识随人员流动丢失。建议保留到“操作可复现”粒度:
不必保留每次会议的逐字记录,也不必保留所有中间草稿。判断标准很简单:如果明天换人接手,他能否仅凭文档做出和当时一致的下一步动作。能,就够。
这种情况下,文档要承担解释和交接双重功能,粒度需要提高一档,但提高的是“可核对性”而不是“数量”。建议保留:
这里的关键动作是给每份数据快照标注时间戳和口径。缺少这两项,数据在交接后很容易被误读,进而让新团队做出与历史结论相反的判断。假设某次调整后流量出现波动,如果快照没有标注统计口径,新团队可能把季节性波动当成调整失败,从而回滚一个本来正确的改动。
多个角色对“该保留多少”有分歧时,争论往往停留在感受层面。更有效的做法是把分歧拆成可核对的问题。
第一步,让每个角色写出自己最需要文档回答的一个问题。例如运营关心“上次改标题的依据是什么”,技术关心“模板改动的回滚点在哪”,管理者关心“谁批准了这次调整”。
第二步,针对每个问题判断:现有文档能否回答。能回答的,说明粒度已够;不能回答的,说明缺的正是需要补的字段。
第三步,只补缺失字段,不整体提高粒度。这样做的好处是把“要不要保留更多”变成“要不要补某一项”,讨论有明确终点。如果三方都无法就缺失字段达成一致,可以先按最小可行粒度保留,并在文档中显式标注哪些信息未保留、后续如需补查应联系谁。
一个可执行的动作是:在项目结束前,由一人负责整理一份“保留清单”,列出每类文档的保留期限和存放位置,另一人负责抽查其中两条记录能否支撑一次实际判断。抽查的作用是验证粒度是否真的够用,而不是只看清单是否齐全。如果抽查发现某条记录无法支撑判断,就回到对应类别补字段,而不是把所有类别都加厚。
例外情况主要有两类。一是涉及合规或合同约定的文档,保留期限和粒度以约定为准,不适用上面的最小化原则。二是项目中途被叫停、结论尚未形成的,此时应保留过程记录而非结论,因为结论本身还不存在,强行总结反而会误导后续接手者。
无论哪种情况,都要避免一个常见误区:把“保留得多”等同于“交接得好”。真正决定交接质量的,是接手者能否找到支撑某个判断的那条依据,而不是文档的总量。