一、把「不用再解释」的东西写下来
反复出现的要求——命名规范、不采用的技术选型、目标用户是谁、哪些操作禁止——应该沉淀成一份短笔记,让它进入每一次任务的上下文。
笔记不需要长,能替代口头交代就够了。写完一段可以自问一句:这件事我是不是每次都要重新说?如果是,它就该进笔记。
- 反复被强调的要求会被记录下来,避免每个人都要重新解释一遍
- 笔记保持简短,长了就没人愿意读,也没人愿意更新
- 记录写成可以直接放进上下文的形式,接手时不用先整理
- 格式保持统一并便于检索,需要时能够快速找到相关的那条
二、给笔记定更新责任
上下文会过期:依赖升级、需求调整、团队换人。笔记需要有负责人和复核时间,过期就更新,而不是继续沿用。
同时保留变更记录。模型答错时,能回看「当时我们是怎么约定的」,比重新讨论一轮要快得多。
- 每份笔记有负责人,过期时知道该找谁更新
- 笔记的有效期能够被识别,超过期限的内容自动浮出来提醒
- 保留每次修改的记录,能看出结论是在什么基础上变化的
- 结论与当时的依据一起保存,避免只剩下没有来由的结论
三、上下文是产物,不是档案
保存下来的上下文只有在被再次使用时才有价值。每条记录都应标注它解决过什么问题,否则半年后没人知道它是否仍然成立。
定期清理过期内容,和持续补充同样重要。过期的上下文会让新成员形成错误的直觉,比没有上下文更麻烦。
- 每条记录都标明它解决过什么问题,脱离背景的结论没有价值
- 过期内容定期清理,笔记库才不会越积越难用
- 结论和给出结论的理由一起保存,方便后来的人理解为什么这么做
- 新人能在十分钟内读懂现有上下文,而不是需要口头传授一周