pstack原则13解释数字实测性能数字在报告前必须验证的5问【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claudepstack 是 Poteto 为 Claude Code、Codex、Copilot 等 Agent 编写的严谨工作流插件包其中的Explain the Number解释数字原则要求任何你实测得到的加速比、延迟、吞吐量或评测结果在报告或据此行动之前必须先弄清是什么限制了它并排除它其实测了别的东西。配合 benchmark-checklist 技能pstack 把这套验证流程拆解成一组可以逐条回答的问题——本文带你用新手也能上手的 5 个问题读懂为什么看似合理的数字可能是错的。为什么一个跑出来的数字可能是假的一次跑错的结果照样会打印出看起来合理的数字。失败的请求、被缓存跳过的计算、根本没执行的代码、某一边停留在默认配置、运行间的噪声——它们全都产出一份看起来很正常的报表。pstack 的判断标准很直白如果你说不出为什么这个数字不能好到两倍那你其实不知道自己测的是什么。出自 principle-explain-the-number/SKILL.md这个原则在 poteto-mode 中被列为验证类原则之一并且有一条硬性触发器跑基准测试、自己测性能、或报告任何实测加速/回归之前必须先过一遍 benchmark-checklist。实测性能数字的5个必问以下 5 问提炼自 benchmark-checklist 的检查清单每一条都要求用运行证据回答而不是靠读代码的猜测。问1为什么不能快一倍找到那个限制器先命名出限制结果的资源或代码路径——一个 CPU 核心、一把锁、磁盘、网络甚至压测工具本身。用剖析器perf、py-spy、node --cpu-prof或系统计数器在运行中取样再把热点映射回源码。⚠️ 特别提醒如果压测端先被打满你测的其实是压测工具。问2两边都调过音了吗每一边都要像生产环境那样跑release 构建、生产参数、连接池、缓存冷热状态、相同版本与数据。如果一边停在默认配置那你比较的是两种配置不是两种实现。此时结论只有一个——重新调优后再测否则不选赢家。问3报过错吗算过账吗统计失败请求和非成功响应错误与成功的耗时特性完全不同——拒绝往往很快超时和重试很慢。同时要做算术去掉占运行 10% 的环节整体最多快约 11%超出物理上限的结果说明这次运行测的根本不是你以为的工作。问4可复现吗每一边至少跑 5 次并且交替进行A、B、A、B…让预热、懒加载和漂移对两边一视同仁。报告中给出中位数和波动区间差距小于运行间波动的视为无显著差异。问5工作真的发生了吗确认计时段内的工作确实执行了请求真的到了服务器、数据真的写入了、懒加载的代码真的被遍历了。无人迭代的生成器、无人 await 的 Promise、超时——都会为从未发生的工作产出漂亮的数字。完整清单还有第 6、7 问有实际意义吗和更细的检查项在 benchmark-checklist/SKILL.md 中逐条展开。正确的报告长什么样pstack 要求报告结论先行更快、更慢、无显著差异、或无法判定。数字必须带着单位、运行次数、波动区间和限制器一起出场例如p50 41ms → 33ms每边 7 次运行的中位数事后区间 32–35ms受单核 JSON 解析限制。而当你说不出限制器、某一边未调优、或无法确认错误与工作是否发生时——结论必须诚实标注为inconclusive无法判定。去哪里读原始规则原则本体plugins/pstack/skills/principle-explain-the-number/SKILL.md完整检查清单plugins/pstack/skills/benchmark-checklist/SKILL.md触发器与原则索引plugins/pstack/skills/poteto-mode/SKILL.md全部命令速查docs/reference.md一句话总结在 pstack 的世界观里数字不是自证清白的——它是一项关于系统的声明而你要负责举证。先过这 5 问再谈快了多少倍。【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考