给实验和功能开关设定去留期限
团队为实验、功能开关和临时代码设定决策日期。保留时须有实际调用方、检查项或观测信号作为依据,淘汰时同步清理相关代码、测试和文档。
AI 深度解读
一个临时工具合并后没人调用,一个试点文档写完后没人按它做事,一个开关还在,但当初要验证的问题早就过去了。作者所在的团队给这些东西加了一条叫「nothing dead」的规则:创建时就定下决策日期,到期前要么正式采用,要么连同配套内容一起移除。
这套做法把「试过了」和「用起来了」分开,也把清理变成实验本身的一部分。规则已经写进仓库,自动检查还在计划中。读这篇最有用的地方,是看清一次实验怎样才算真正结束。
实验为什么要在创建当天定下决策日期
给实验设决策日期,是把「以后再看」变成团队约定的一次决定。规则覆盖实验、功能开关、工具、文档和代码路径。即使还处于探索阶段,也要写清这个状态什么时候到期。
作者所在的仓库已有 3 个文件名里带 experiment 的受版本控制文件。其中一个是只读的代码映射工具,会在选定文件里找出没有其他语法引用的名字。作者特意注明,这个结果无法证明某个定义已经废弃,也无法证明它可以安全删除。工具有探索价值,但作者拿它举例,正是因为这类产物很容易卡在中间:没接入实际流程,也没人定下什么时候决定去留。
从 11 月初起,这个工作副本已经积累了约 2,000 次提交,大多是经过检查的小改动。这个数字说明了仓库的变更节奏。小步提交可以让实验很快落地,实验的去留如果一直悬着,后来接手的人就得逐个判断它们还有没有用途。
正式采用和退役,各要留下什么证据
正式采用要能指出谁在用,或者它接入了哪项检查、产生了什么信号,并写清支持采用的证据。对工具来说,可以落实为一个实际调用点。对文档来说,可以指出哪条工作流程会读它、用它做决定。跑通过一次,只能说明它被试过。
退役则要把实验产物和专属测试、文档、已登记的边界一起删掉。只加一句「已废弃」,下次读到这里的人仍然要查它是否还有调用、测试为何还在、文档里的说明是否有效。两种结果都要能从仓库里看出来。
团队已经把规则写进 2 个受版本控制的文件:供 wakes 读取的种子契约和团队文化笔记。原文没有展开 wakes 的运行方式。
团队打算怎么发现逾期和漏登记
他们已在工作事项登记表里安排了实验生命周期检查,明确了负责人和交付日期。计划中的实验登记表会记录 id、负责人、开始日期、决策日期,以及实际使用方或支持保留的证据。状态有三种:running(进行中)、adopted(已采用)和 retired(已退役)。
扫描还会找出自称实验、试点或探索性工作的产物,看它们有没有登记。超过决策日期亮黄灯,再过一周亮红灯。登记表读不到时显示 unknown(未知)。检查没能读取数据时,团队看到的是缺少结果,没法据此判定所有实验都在期限内。
这套检查尚未上线。作者给出的检验点是,检测器上线后,第一条逾期事项什么时候真正得到处理。只有走到那一步,才有机会观察提醒能不能推动决定。
我的判断
我认同把采用条件写成调用点、检查或实际使用方。尤其是内部工具,试跑时能产出结果,和有人会据此改代码、看报告,是两件不同的事。前一种结果支持继续评估,后一种才说明它进了工作流程。
原文记录了文件盘点、提交量和规则落地,没有对照数据证明规则能减少遗留项,也没交代统一扫描的误报情况。目前这是一套有具体例子的经验做法。对于实验不多、评审时能逐个追踪的团队,把决策日期和接手人放在现有 issue 里就能试行。统一登记和扫描的额外价值,在于能跨目录找出漏登记的产物,并把逾期情况集中展示出来。能否兑现这个价值,还得看有人收到提醒后会不会处理。
能拿来做什么
- 给前端灰度开关建 issue 时就写好决策日期、负责人和采用依据。到期评审时明确哪条代码路径会留下,并把淘汰分支、专属测试和文档纳入同一次清理。
- 用 AI 写出一个供试验的 Node 脚本时,先约定正式采用对应哪个调用点,例如仓库里哪条检查会执行它、谁会看输出。到期仍没有实际用途,就把脚本和相关说明一起移除。
- 在现有 issue 或登记表里标记逾期实验,提前约定原负责人没处理时由谁接手。评审时查看哪些已接入、哪些已删除、哪些仍待决定。