SuperAPI AI 工具集

cursor-delegate

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:把有边界的编码任务委托给独立的 Cursor Agent CLI(cursor-agent)实现者,编排者负责写任务说明、审查产出并最终提交。仅在用户明确要求委托时使用;任务足够小可内联完成、或未安装/未认证 cursor-agent 时不宜使用。

主要能力:五步循环——写说明(只发文本,Cursor 看不到聊天历史,需含目标、现状、要改与不可改内容、项目实际门禁、报告契约,并要求不要提交);派发(用内置 relay 封装 cursor-agent -p,从 stdin 喂说明,捕获结构化事件流并写入 result.json);等待完成(命令阻塞直到结束,建议用后台命令或轮询 result.json);审查(不信任自报,自己重跑门禁、对照说明读 diff、检查 touchedFiles);落地(实现者改工作树,编排者提交,需返工则用 delta 说明加 --resume-last 或 --session <id>)。

必要用法:先确认 cursor-agent --version 成功、cursor-agent status 显示已登录,并在目标 git 仓库内或通过 --cd 指向该仓库。派发示例: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>、--timeout 2h。默认具备写权限并带 --force,命令无需批准即可运行;relay 始终传 --trust,因此 --cd 只能指向可信仓库。

适用场景:需要委托可界定编码任务并自行审查 diff 与门禁的开发流程;也可用 --read-only 获取不写文件的对抗性第二意见。

限制:本文档为仅文档导入,未包含可执行 scripts/relay.mjs,需见上游获取完整运行时;需 cursor CLI、Node 18+、git。relay 从不提交,只返回结构化结果 JSON。若在 Windows 上配置了 Cursor hooks,从 Git Bash(MSYS)派发会导致命令被 hook 包装阻塞,建议改用 PowerShell 或 cmd。Cactus 报告中的 sandbox 与 permissionMode 只反映请求值,需自行检查 touchedFiles 与 diff。