SuperAPI AI 工具集

principle-explain-the-number

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:在信任、汇报或依据某个测量数字行动之前应用,例如加速比、性能回退、吞吐量、延迟或评测结果。核心是弄清这个数字究竟测的是什么。

主要能力:要求回答“为什么没有翻倍”,指出限制结果的资源或代码路径,例如某个核心、锁、磁盘、网络或负载生成器本身。限制因素必须来自运行期间采集的 profile 或系统计数器,并映射到源码;仅凭阅读代码猜测不算限制因素。若说不出为什么数字没有好一倍,就说明并不了解所测内容。

还需列出该数字可能测到的其他东西,并用证据逐一排除,常见嫌疑包括错误、被跳过或缓存的工作、从未运行的代码、未调优的一侧(仍为默认设置)、噪声,以及端到端影响过小的部分。

使用方式:把证据与数字放在一起,在笔记或链接产物中记录运行次数、离散程度和限制因素。性能数字按 benchmark-checklist 技能执行完整流程;评测结果则对每次试验提出同样问题:每次运行是否都完成了任务、差距是否跨试验和模型成立、场景是否有意义。

限制:当数字背后的证据没有运行次数、没有离散程度、没有具名限制因素,或节省的时间大于被改动部分本身耗时,就说明跳过了该原则。它与 Prove It Works 不同,后者检查输出是否真实。资料未提供安装命令或平台信息。