mcpField
H
hyperfine-benchmarking

hyperfine-benchmarking

github.com/akillness测试与质量53248 次安装4 天前更新
代码仓库

关于 hyperfine-benchmarking

hyperfine-benchmarking 是用于在可复现条件下测试命令行性能的技能,帮助开发者比较命令变体、评估脚本改动,并整理结果供审阅。

主要功能

  1. 01比较多个命令行命令
  2. 02执行预热和多次测量
  3. 03扫描命令参数组合
  4. 04导出 JSON 和 Markdown 结果
  5. 05记录基准测试条件

适用场景

  1. 01比较不同的命令实现
  2. 02测量脚本修改前后的性能
  3. 03为 Pull Request 附上基准测试证据
  4. 04排查波动较大的测量结果

安装

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

$npx skills add https://github.com/akillness/jeo-skills --skill hyperfine-benchmarking

安装后在 Claude Code 中输入/hyperfine-benchmarking确认已加载。

详细介绍

hyperfine-benchmarking

使用可复现的方法对 CLI 命令进行基准测试,而不是只看一次性的 time 输出。

适用场景

  • 比较两个或更多命令变体(tool-a 与 tool-b)
  • 验证脚本更改前后的性能影响
  • 在 PR 中附上基准测试证据

说明

  1. 确认工具可用。
  2. 确保比较的命令使用相同的输入、工作目录和环境。
  3. 运行预热,并进行足够多次测试以获得稳定的方差。
  4. 导出 JSON/markdown 格式的结果,供审阅。
  5. 总结相对加速比和风险提示。

示例

检查工具是否可用
hyperfine --version
比较两个命令
hyperfine \
  --warmup 3 \
  --min-runs 10 \
  'cmd_a --with flags' \
  'cmd_b --with flags'
参数扫描
hyperfine \
  --warmup 3 \
  --parameter-list mode fast,balanced,thorough \
  'mytool --mode {mode} input.txt'
导出产物
hyperfine \
  --warmup 3 \
  --min-runs 10 \
  --export-json benchmark.json \
  --export-markdown benchmark.md \
  'cmd_a' 'cmd_b'

最佳实践

  • 优先使用相对加速比和置信区间,而不是单次运行的结果。
  • 除非对输出进行标准化,否则不要比较语义不同的命令。
  • 如果方差较大,请增加运行次数或减少后台干扰后再下结论。
  • 在 PR 文本中记录数据集/路径和准确的命令字符串。

参考资料

评论

支持 Markdown