Explain the Number 是一项在信任、汇报或依据某个测量数字行动之前应当先应用的原则性技能。它适用于你测量得到的任何数字,包括加速比、性能回退、吞吐量、延迟或评估结果。
核心做法是追问“为什么没有翻倍?”。你需要指出限制该结果的资源或代码路径,例如某个核心、一把锁、磁盘、网络或负载生成器本身。这个限制因素必须来自运行期间采集的性能剖析或系统计数器,然后映射到源代码。仅凭阅读代码得出的猜测不能算作限制因素。如果你无法说明为什么这个数字没有好上一倍,那就说明你并不清楚自己测量的是什么。
其次,列出这个数字还可能测量了哪些其他内容,并用证据逐一排除。常见的嫌疑包括:错误、被跳过或缓存的工作、从未运行的代码、未调优的一侧(仍处于默认设置)、噪声,以及端到端影响过小的部分。
第三,把证据与数字放在一起。在笔记或链接的工件中记录运行次数、离散程度和限制因素。
对于性能数字,应配合 benchmark-checklist 技能执行完整流程。对于评估结果,则要对试验提出同样的追问:每次运行是否都完成了任务,差距是否在多次试验和多个模型之间保持,场景是否重要。
如果你发现某个数字背后的证据没有运行次数、没有离散程度、没有具名限制因素,或者节省的时间大于被改动部分本身所花的时间,那就说明你跳过了这一原则。
该技能与“Prove It Works”不同,后者检查的是输出是否真实。