principle-explain-the-number

来源

这是中文译文，方便对照阅读。本站不发行中文版插件。

对照英文：本站英文页

英文原文出处：cursor/plugins 仓库 pstack/skills/principle-explain-the-number/SKILL.md（提交 23e4138）

解释这个数字

测出来的数字是对一套系统的主张。在相信它、汇报它、或据此行动之前，找出限制它的因素，并排除它测到的其实是别的东西。

原因： 一次出了问题的运行，照样会打印出一个看起来合理的数字。请求失败、缓存跳过了工作、代码根本没跑、有一方留在默认设置，以及各次运行之间的波动，都会给出看起来没问题的结果。如果你说不出这个数字为什么没有好一倍，你就并不知道自己测的是什么。

做法：

• 问「为什么不是两倍？」 说出卡住结果的资源或代码路径，例如某个核心、一把锁、磁盘、网络，或施压程序本身。依据必须来自一次运行中的剖析（profile）或系统计数，再对应到源码。光读代码猜出来的，不算限制因素。
• 列出这个数字还可能在测别的什么，并用证据逐条排除。 常见的有：出错、工作被跳过或命中缓存、某一方没调优、随机波动，以及改动部分小到对整条路径不重要。
• 把证据和数字放在一起。 在笔记或一份链接到的产物里写上运行次数、波动范围和限制因素，让读者能核对这个主张。

性能数字要完整走一遍 benchmark-checklist。评测结果问同样的事：每次是否真的完成了任务，差距在多次试验和不同模型之间是否成立，这个场景是否重要。

证据里没有运行次数、没有波动范围、或没有点名的限制因素，或者声称节省的时间比被改的那部分原本花的还多，就是跳过了这条原则。

这和 Prove It Works 不同。那条检查产出是真的。这条检查测到的数字确实是你说的那个意思。