Parameter Golf 监控器

一项用于实时跟踪 openai/parameter-golf 竞赛排行榜的技能，通过调用 GitHub 公共 API 获取处于 open 和 merged 状态的 PR 实现。

该技能的功能

scripts/monitor.py 中的监控脚本会查询 GitHub API，获取 openai/parameter-golf 仓库的所有 PR，从 PR 标题与正文提取 val_bpb 分数，对提交进行分类（record / 非 record），并以排名形式展示排行榜表格。

它**无需任何身份认证**——直接使用未认证的 GitHub API（限速：60 次请求/小时）。

适用场景

• 用户询问：“当前排行榜如何？”或“谁在 Parameter Golf 中领先？”
• 用户想查看自己的排名：“我在什么位置？”或“我的 PR 情况如何？”
• 用户询问竞争对手的分数或所用技术
• 用户希望监控新提交或变更
• 用户说：“检查一下比赛”或“给我看看排名”
• 用户希望将自己的分数与全体参赛者进行对比

运行方式

脚本位于本技能目录下的 scripts/monitor.py。使用 Python 3 运行（仅依赖标准库，无需额外安装依赖）。

一次性获取排行榜

python3 /scripts/monitor.py

显示所有 open 状态的 PR，并按 val_bpb 排序（数值越低越好）。

高亮指定用户

python3 /scripts/monitor.py --me 

将该用户的 PR 标记为 <--，并在摘要中显示其排名及与第一名的差距。若用户希望启用高亮但你尚未知晓其 GitHub 用户名，请主动向其询问。

常用参数组合

全部参数说明

• --me USER —— 高亮指定 GitHub 用户名；同时显示其排名及与第一名的差距。
• --top N —— 仅显示得分最高的前 N 条记录（被高亮的用户始终显示，即使其排名超出前 N）。
• --records-only —— 排除非 record 类型的提交。
• --merged —— 仅显示已合并（merged）的 PR。
• --all —— 同时显示 open 和 merged 的 PR。
• --since YYYY-MM-DD —— 仅筛选创建时间在该日期及之后的 PR。
• --json —— 以 JSON 格式输出（而非表格），适用于管道传递至 jq 或其他工具处理。
• --watch MIN —— 每 N 分钟持续轮询一次（按 Ctrl+C 停止）。

结果解读

• Rank（排名）依据 val_bpb 升序排列（越低越好）；仅含有效分数的 PR 才获得数字排名。
• Status（状态）显示为 open、merged 或 non-rec（非 record 提交）。
• 分数标记为 ? 表示无法从 PR 标题或正文中提取出 val_bpb 值。
• 部分极低分（例如 < 1.10）可能仅用于评估目的，或采用了非标准配置——请查阅对应 PR 的详情确认。
• 摘要中的 gap to #1（距第一名差距） 显示被高亮用户当前分数与榜首之间的差值。

速率限制

GitHub API 对未认证请求限制为每小时 60 次。每次 run_once 调用消耗 1 次请求（仅查询 open PR）或 2 次请求（启用 --merged 或 --all 时）。--watch 模式严格遵守该限制——每 5 分钟轮询一次，约消耗每小时 12–24 次请求。

若触发速率限制，脚本将显示错误信息，并在下一轮轮询周期自动重试。

输出示例

[2026-03-20 02:17:15] Parameter Golf Leaderboard (open PRs)

Rank   val_bpb     PR  Status    Author              Date        Title
----------------------------------------------------------------------------------------------------
   1   1.15390  #135   open      unnir               2026-03-19  Record: OrthoInit + Int6 MLP3x + BigramHash + SmearGate
   2   1.15800  #106   open      krammnic            2026-03-19  record: 1.158
   3   1.15850  #122   open      mtybadger           2026-03-19  Record: Sliding Window Eval, 2048 Vocab Size
   4   1.16019  #156   open      dexhunter           2026-03-20  Int6 STE + NorMuon + SWA + Sliding Window  <--

Best: val_bpb=1.15390 (#135 by unnir)
Total: 56 PRs, 40 with scores

You (dexhunter): rank #4, val_bpb=1.16019, gap to #1: +0.00629