用途:把边界明确的编码任务交给 Cursor Agent CLI 作为后台实现者执行,你作为编排者编写任务说明(brief)、审查产物并自行提交。不适用:任务小到可直接手写、cursor-agent 未安装或未登录(先运行 cursor-agent login)、或你想自己写代码。
前提:cursor-agent --version 成功;cursor-agent status 显示已登录;当前目录或 --cd 指向目标 git 仓库(relay 会传 --trust,只指向可信仓库);未提供安装细节。
主要能力与用法:使用技能内置脚本 scripts/relay.mjs 包装 cursor-agent -p,从 stdin 读入 brief,收集结构化事件流并写出 result.json,不自动提交。示例:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo。可选参数:--read-only(计划模式,只读审查)、--no-force(可写但不自动批准命令)、--sandbox enabled|disabled、--model <name>(取自 cursor-agent models 输出)、--resume-last、--session <id>(仅发增量 brief)、--timeout 2h。省略 --model 使用账号默认;实际模型记录在 result.json 的 resolvedModel。
流程:1)写 brief,含目标、现状、改动范围、不可动部分、项目真实门禁与报告约定,要求不要提交,一任务一 brief;2)派发;3)等待完成,进程退出且 result.json 存在即完成,完整报告在 finalMessage;4)审查,不信任自述,自行重跑门禁、对照 brief 读 diff(从 touchedFiles 开始);5)门禁通过后由你提交,需返工则用 --resume-last 或 --session 发增量 brief。失败:用法错误退出码 2 且不写 result;缺少 cursor-agent 退出码 127 并写 status: cursor_agent_unavailable。
限制与注意:默认写权限带 --force,无头运行无法弹审批,需审批的命令会被拒绝;Windows 若配置了 Cursor hooks(如 ~/.cursor/hooks.json 或 Claude Code PreToolUse hooks),从 Git Bash 派发会导致命令被拦截,建议改用 PowerShell 或 cmd。资料未提供价格、平台支持范围与具体效果数据。