先把笔记分成“可复现动作”和“解释性结论”两层,再决定修订方式:前者需要重新跑一遍小样本验证,后者需要找到分歧来源并改写成可核对的项目。不要整本推翻,也不要只改日期。
过往知识失效通常有两种表现。第一种是动作还在,但结果变了,比如同样的抓取诊断流程,过去能定位到某类问题,现在跑完却看不出异常。第二种是结论还在,但前提变了,比如过去认为某类页面结构一定不利于收录,现在多个角色对同一事实有不同理解。
这两种情况对应不同修订动作。动作层失效,优先重跑验证;结论层失效,优先把分歧转成可以核对的项目。判断依据不是“感觉过时了”,而是你能否说清:哪个输入变了,哪个输出不再出现,或者哪两个角色对同一现象给出了相反解释。
一个可用的区分信号:如果笔记里的步骤可以写成<检查项>并产生一个可观察结果,它属于动作层;如果笔记里写的是“因为……所以……”,它属于结论层。动作层修订后要留下新结果,结论层修订后要留下判断条件。
个人笔记的修订成本低,但容易把偶然现象写成规律。建议先做一次小样本复跑:从旧笔记里挑三条你过去最常引用的动作,用当前手头的一个页面或一个站点片段重新执行,记录每一条的实际输出。
如果三条里两条输出与旧记录一致,说明笔记主体仍可用,只需在失效那条旁标注“前提未满足”或“当前样本不适用”。如果三条里两条以上输出不一致,不要急着改结论,先把不一致的输入条件列出来,比如页面类型、内容量级、站点结构差异。这一步的动作结果是:你会得到一张“输入—输出”对照,而不是一句“旧方法没用了”。
接下来修订笔记的写法。把原来的“应该这样做”改成“在什么条件下这样做,观察到什么结果”。例如旧笔记写“先提交再观察”,新笔记写“内容量级较小的页面,先提交并记录首次可观察变化的时间点;若两周内无可观察变化,回到抓取诊断而不是继续提交”。这里的数字只是说明比较方法,不是见效承诺。
例外情况:如果旧笔记涉及的是你无法独立复现的外部规则,个人复跑不足以支撑修订。此时应把它降级为“待核对假设”,而不是直接删除或直接沿用。
当编辑、开发、运营对同一现象给出不同解释时,笔记修订的重点不是选谁对,而是把分歧变成可以核对的项目。做法是先把各方说法写成互斥的候选解释,再为每个解释设计一个最小核对动作。
这样做的实际结果是:笔记从“结论集合”变成“判断条件集合”。下一次再遇到同类分歧,你可以直接引用上次的核对项目,而不是重新争论。需要提醒的是,某个指标归零或某项请求量下降,不能单独证明某种解释正确,它还可能来自样本变化、统计口径调整或外部波动。核对项目要尽量写成“排除法”,而不是“证明法”。
取舍一:先改结构还是先补内容。如果旧笔记已经超过你一次能读完的长度,先改结构,把动作层和结论层分开;如果笔记很短但错误集中,先补核对条件。结构混乱时补内容只会让下次修订更难。
取舍二:保留旧版本还是直接覆盖。涉及判断条件的结论,保留旧版本并标注失效前提;涉及纯操作步骤的,可以直接覆盖,但要在旁边留一行“上次验证时间与样本类型”。保留旧版本的价值在于,当新条件再次出现时你能快速回退。
取舍三:把分歧写进笔记还是留在讨论里。如果分歧反复出现,写进笔记并附核对项目;如果只出现一次且无法复现,留在讨论记录里即可,不必污染操作笔记。
假设三位角色对同一批页面有不同理解:编辑认为内容质量不够,开发认为页面结构有问题,运营认为提交频率不够。旧笔记只写了“收录慢先查内容”。
修订时不要直接改写结论,而是把三种解释转成三个核对项目:内容解释对应“同一模板下,内容量级不同的页面是否表现出不同结果”;结构解释对应“同一内容量级下,结构不同的页面是否表现出不同结果”;提交解释对应“同一页面在改变提交节奏前后,可观察变化是否不同”。每个项目只改变一个变量,并记录样本类型。
执行一轮后,笔记里留下的不是“谁对”,而是“在什么样本下,哪种解释被支持或被排除”。下一步动作因此变得明确:如果结构解释被支持,就去改结构核对清单;如果三种解释都未被支持,就把问题标记为“当前样本不足以判断”,而不是硬写一个结论。
一份修订过的操作笔记,至少应包含:动作步骤、适用前提、可观察结果、以及当结果不符时的下一步动作。缺少“下一步动作”的笔记,下次失效时你仍然只能重头争论。
最后检查一遍:如果明天有人拿着你的笔记去执行,他能否在不问你任何问题的情况下,知道什么条件下做什么、看到什么算符合预期、不符合时回到哪一步。能通过这个检查,修订才算完成。