关于 add-runner-eval
用于添加 Runner 评测的技能,评测真实 Paperclip Runner/Provider 会话与预置的模拟控制平面交互。它区分 paperclip-evals 中的用例编写和 Runner 集成,并强调确定性断言、验证及经审查的证据发布。
主要功能
- 01定位 Paperclip 与评测仓库
- 02设计有限范围用例和断言
- 03用例、夹具、配置与名单指引
- 04无 Provider 验证流程
- 05证据与评分校准
- 06公开输出及来源信息保护
适用场景
- 01添加 Runner 协议评测
- 02更新实时评测名单
- 03调用 Provider 前验证用例
- 04准备经审查的公开评测结果
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ paperclipai/ paperclip --skill add-runner-eval安装后在 Claude Code 中输入/add-runner-eval确认已加载。
详细介绍
添加 Runner 评测
此技能适用于 Runner 评测系列:与已植入数据的模拟控制平面进行真实 Runner/提供方会话。 产品浏览器/服务器/数据库/Daytona 覆盖范围属于 add-product-e2e-eval。
如果提供了 PAPERCLIP_ROOT,则据此定位 Paperclip 检出目录;否则,从检出目录运行
git rev-parse --show-toplevel。如果当前目录不属于 Git 仓库,请检查工作区根目录
(例如 ~/paperclipai/paperclip),并确认所选根目录包含 packages/paperclip-runner 和 tests/runner-e2e。
通过 PAPERCLIP_EVALS_ROOT 或发现的同级目录定位 paperclip-evals;工作树的父目录不一定包含该仓库。
阅读 doc/evals.md 和 packages/paperclip-runner/docs/runner-protocol-live-evals.md,
然后在编辑前检查最近的现有用例、名册、架构和报告测试。定义和编写的用例属于同级仓库
paperclip-evals/evals/paperclip-runner;Runner 集成、聚合、查看器和发布行为属于 packages/paperclip-runner。
在名称和文档中明确控制平面边界。
同级评测仓库的 README 是具体指南:用例位于 cases/,
公司夹具位于 fixtures/,运行时/模型设置位于 configs/,
选择集位于 rosters/,维护中的活动成员列表位于 campaigns/live-direct-full.json。
如果计划要求,请更新清单/覆盖映射;仅新增文件并不会将其加入维护中的活动。请在评测仓库根目录中,
针对修改过的用例和名册调整并运行以下无提供方检查。只有在该独立计划发生变化时,才运行可靠性计划验证器:
python3 evals/paperclip-runner/tools/eval_program.py validate \
--case evals/paperclip-runner/cases/get-task-context.json \
--config evals/paperclip-runner/configs/live-codex-pinned.json
python3 evals/paperclip-runner/tools/run_live_roster.py validate \
--roster evals/paperclip-runner/rosters/live-mini.json --run-id validate-new-case
python3 evals/paperclip-runner/tools/run_live_campaign.py validate \
--campaign evals/paperclip-runner/campaigns/live-direct-full.json
python3 evals/paperclip-runner/tools/reliability_campaign.py validate \
--plan evals/paperclip-runner/campaigns/paperclip-runner-reliability.json
参考附近的正向和负向评分器用例/夹具来校准新断言,包括评分器必须失败关闭时的格式错误或缺失证据。 保留现有的机器处置结果和评分;产品、模型/提供方、评分和基础设施标签属于分析性注释,而不是改写分类器的指示。
编写一个范围明确的用例,其中包含确定性的语义断言和可检查的结果。声明预期操作、状态影响、提供方通道/配置、超时和重试策略,以及任何必需证据。不要评判隐藏推理,不要根据提供方的终止消息推断成功,也不要编造对话/工具证据。公开输出须遵循经审核的投影:可以发布经过净化的夹具对话和允许列表中的工具结果;不得发布原始可信产物、凭据、机密、私有引用和隐藏推理。
首先使用上述命令和 Runner 文档中记载的相关报告/渲染验证,在不调用提供方的情况下进行验证。获准进行实时运行时,固定 Paperclip 提交以及精确的 40 位
paperclip-evals 提交,选择最小且有用的名册,并保留完整的来源记录和成本记录。
当契约或命令发生变化时,更新权威的详细文档,然后在 doc/evals.md 中添加链接,而不是重复 Runner 操作手册。保持公开报告不可变并使用经审核的投影;可以公开经过净化的夹具对话和允许列表中的工具结果,但不得暴露凭据、机密、私有引用、原始可信负载和隐藏推理。