mcpField
P
principle-explain-the-number

principle-explain-the-number

github.com/mdsmithaustin测试与质量8116 次安装1 天前更新
代码仓库

关于 principle-explain-the-number

principle-explain-the-number 是用于审视性能和评测结果的技能,要求提供瓶颈、其他可能解释及运行差异的证据,并指向 benchmark-checklist 获取完整流程。

主要功能

  1. 01识别测量中的瓶颈
  2. 02排除错误与未执行的工作
  3. 03检查结果对端到端体验的影响
  4. 04记录运行次数和波动范围
  5. 05将原则用于评测试验

适用场景

  1. 01审查缺少明确证据的性能结果
  2. 02检查测得的提升是否可复现
  3. 03评估测试试验是否完成任务

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mdsmithaustin/pstack --skill principle-explain-the-number

安装后在 Claude Code 中输入/principle-explain-the-number确认已加载。

附带文件agents/openai.yaml

详细介绍

解释这个数字

  • 问一句“为什么不是两倍?” 找出限制结果的资源或代码路径,例如核心、锁、磁盘、网络或负载生成器本身。通过运行期间的性能分析或系统计数器找出它,再映射到源码。仅凭阅读代码得出的猜测不能算限制因素。如果你说不清为什么这个数字没有好一倍,那你就不知道自己测量的是什么。
  • 列出这个数字还可能测量了什么,并用证据逐一排除。 常见情况包括错误、跳过或缓存的工作、从未运行的代码、一侧未调优(仍使用默认设置)、噪声,以及端到端影响微不足道的部分。
  • 将证据与数字放在一起。 在备注或链接的产物中记录运行次数、波动范围和限制因素。

对于性能数字,请使用 benchmark-checklist 技能完成完整流程。对于评估结果,也要对各次试验提出同样的问题:每次运行是否都完成了任务,差距是否在不同试验和模型中都成立,以及场景是否重要。

如果某个数字背后的证据没有运行次数、波动范围或明确指出的限制因素,或者节省的时间超过了被修改部分原本耗费的时间,那么你就跳过了这项检查。

这与 证明它有效 不同;后者用于检查输出是否真实。

评论

支持 Markdown