SuperAPI AI 工具集

create-runner-adapter

编程与开发

查看项目

更新于 10-19 22:31

技能介绍

本技能用于向 Paperclip 新的原生 Runner 执行系统添加 harness。这里的适配器指 Runner harness 驱动背后的 provider 翻译与启动集成。使用时需保留既有直接适配器与历史记录作为兼容约束,不通过原有包编写流程处理此工作,也不顺带迁移 agent。

用途与工作序列:技能提供完整的 Runner 集成操作手册,包含发布契约、能力清单、验收台账和失败记录等模板。流程包括:定义有限范围的发布(用户结果、首个环境、支持平台、安装/认证、所需能力、验收模型、花费限制、交付目标);调研实际 harness(官方文档、原生源码或已发布代码、真实协议流量、账户/模型行为),按原生、包装层、Runner、控制器、UI 逐层追踪能力;先证明一个完整切片(模型与指令准入、作用域工具与凭据、完成一个真实任务并独立核验输出与清理);补齐承诺行为(事件、人工决策、回调身份、恢复、取消、终态结算);证明交付(干净安装包、约定执行环境、完整运行时闭包与不可变镜像标识);资格确认(确定性检查与真实依赖检查,再通过浏览器/服务端/DB/Runner/provider 跑精确的 Product E2E 用例);最后交付可操作结果,区分仓库检查、通过证据、剩余限制、安装、操作与回滚,并区分合并、发布、部署和金丝雀状态。

适用场景:需要为 Paperclip Runner 新增原生 harness/provider 集成,并希望以可重复验收和真实交付证据完成资格确认的开发工作。

限制与注意事项:若技能单独安装,需从当前工作区或 git rev-parse --show-toplevel 定位目标检出,确认包含 packages/paperclip-runner 与 tests/runner-e2e,并遵循该检出的 AGENTS.md 与范围规则。资格模型是重复测试选择而非产品允许列表,需在首次提示前于原生边界验证调用方确切模型。指令传输成功不等同于内容绑定正确,需拒绝缺失确认并验证行为。原生问题、语义问题、计划与权限请求是不同契约,需保留身份并证明送达。同一会话不等于同一进程或可恢复的待处理输入。截图、模型自述成功或单元测试全绿不能替代独立文件/产物/状态/清理检查。变更通过后需做证据影响判断,旧结果保留原始运行时、模型、环境与测试夹具身份。需证明原生子进程自发丢失与有界关闭,而非仅测试触发的清理。需明确并发所评定的内容,Stop 用例需触及真实待处理工作。需跨中断保留活动证据、预算历史与候选/发布状态。需通过聚焦回归检查保留旧行为。新指导应写入可共享的跟踪文档,不替代为个人会话链接或不可访问证据。