用途:当用户明确要求把一项有边界的编码任务交给独立的 omp(Oh My Pi)实现者,并由编排者自行审查 diff 和落地提交时使用。任务过小、omp 未安装或未认证、用户要的是原版 Pi CLI(pi)时不应使用。
主要能力:通过捆绑的 relay 脚本把任务简报经 stdin 传给 omp --mode json,捕获 JSON 事件流并写出 result.json;支持选择模型、provider、思考等级、只读运行、恢复会话、超时看门狗等。
使用方式:先安装并认证 omp,确认 omp --version 成功,并在目标 git 仓库中工作。用 omp models、omp models --json、omp models find <substring> 等子命令列出可用模型(不要用已移除的 omp --list-models)。派发示例:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo,可加 --model、--provider、--thinking、--read-only、--approve、--resume-last、--session、--timeout。relay 默认不提交,只返回结构化结果。
适用场景:把有边界的实现任务交给 omp,再由编排者重跑项目门禁、阅读 diff、必要时用 delta 简报返工,最后自行提交。
限制:omp 没有沙箱;可写运行总是传 --yolo,只读运行把工具限制为 read、grep、glob。relay 默认传 --no-extensions --no-skills --no-rules,需 --approve 才信任项目 .omp 资源。relay 不转发 --api-key、--smol、--slow、--plan。需要已安装并认证的 CLI、Node 18+ 和 git。