SuperAPI AI 工具集

relay-sidecar

编程与开发

查看项目

更新于 10-16 05:46

技能介绍

用途:为已存在的 relay 运行执行纯产物型(artifact-only)辅助 sidecar。它不属于必选的 plan → dispatch → review → merge 生命周期,/relay 也不要求 sidecar 步骤;sidecar 输出仅为咨询性内容,不构成执行证据或评审证明,门禁决策仍应使用 relay-review,实现派发用 relay-dispatch,编写评分标准或派发提示用 relay-plan,合并或收尾 PR 用 relay-merge。

适用场景:为已有 relay 运行执行纯产物型辅助 sidecar;采集补充性的上下文回顾、测试缺口、文档同步等输出;在运行的 sidecars/<id>/ 目录下生成非门禁型 sidecar 产物。不适用于 PR 门禁评审、实现派发、评分标准或派发提示编写、运行前子系统侦察、合并或收尾 PR。

主要能力与运行方式:runner 解析运行清单,将运行上下文与 PR diff 文本发送给配置的 sidecar 执行器,并把捕获的 stdout 存到该运行的 sidecars/<id>/ 目录。输入包括可选的 RELAY_SKILL_ROOT(默认 skills)、已有 relay 运行清单、已解析的运行上下文、PR diff 文本,输出生成在 sidecars/<id>/ 下;同级脚本为 ${RELAY_SKILL_ROOT:-skills}/relay-sidecar/scripts/relay-sidecar.js。

入口命令:node "${RELAY_SKILL_ROOT:-skills}/relay-sidecar/scripts/relay-sidecar.js" --run-id <id> --kind <name> [options]

参数:--run-id <id> 必填,relay 运行 id;--kind <name> 必填,sidecar 类型,已知计划类型有 context-recap、test-gap、docs-sync,但本 runner 接受任意非空字符串;--executor <name> 执行器,默认 opencode,本版本仅接入 opencode;--model <provider/model> 可选模型覆盖并透传给执行器;--variant <name> 可选 sidecar 变体,会包含在生成的 sidecar id 中;--dry-run 解析并打印计划信封,不调用执行器、不发出 sidecar 事件;--json 打印供 runner 响应的结构化 JSON 信封,执行器 stdout 仍存为 output.md;--help、-h 打印用法。

限制与信任边界:sidecar 输出仅为咨询性质,不计为执行证据或评审者证明,也不能满足实现、评审或合并的证明要求;sidecar 结果事件包含 elapsed/关键路径计时字段,默认 consumed_by_phase=metrics,除非未来编排器提供更窄的阶段分类,这遵循 relay-dispatch/references/reviewer-policy-opencode.md 中的 opencode 策略。收费、价格、平台等其他信息暂未提供。