# 派出去 · Cloud Agents、CLI 与自动化 · Cursor · 一台元工具 **作者** Aklman · **章节** 08 / 11 · **首发** 2026.07 · **语言** 中文为主, 中英双语 **原文** https://library.aklman.com/books/cursor/08-send-out **全书 markdown** https://library.aklman.com/books/cursor/llms.md **上一章** https://library.aklman.com/books/cursor/07-mcp/llms.md **下一章** https://library.aklman.com/books/cursor/09-beyond-code/llms.md > 本章来自 Aklman · Library, 完整免费阅读。允许 AI 摘读、引用、问答; 转载请保留作者署名与原文链接 (CC BY-NC-ND 4.0, https://library.aklman.com/license)。 --- > 有些活不用你守着：交给云端 agent，它在自己的机器上跑，你去忙别的；放进 CLI，它在终端和 CI 里无人值守地跑；设条自动化，它按时间或事件自己触发。Cursor 把同一个 agent 铺到了网页、iOS、Slack、GitHub 上，还给了一套 SDK 让你编排它。这一章讲哪类活值得派出去（包括 Bugbot 那种自动 PR 评审），哪类还是留在你眼前。 有些活不用你守着：交给云端 agent，它在自己的机器上跑，你去忙别的；放进 CLI，它在终端和 CI 里无人值守地跑；设条自动化，它按时间或事件自己触发。 Cursor 把同一个 agent 铺到了网页、手机、Slack、GitHub 上。前面几章的 agent 是「陪你做」的，这一章讲「派出去做」的那一面 —— 哪类活值得交出去（包括 Bugbot 那种自动 PR 评审），哪类还是留在你眼前。 ### I · Cloud Agents：派出去，它在自己机器上跑 本地 agent 占着你的机器和注意力；云端 agent 不占。 云端 agent（原 Background Agents）各自有一台隔离 VM，可以并行跑好几个，还带 computer use 沙箱去验证自己的产出。[^1]发起入口铺得很开：网页、iOS app、桌面、Slack / Linear 里 @cursor、GitHub / Bitbucket 的 PR 评论里 @cursor，也能把本地或 CLI 上跑着的活 handoff 到云端继续。它克隆你的仓库、在自己机器上改完、交一个 PR 回来。 「派出去」也不非得整单外包：3.7 起，本地会话里 /in-cloud 就能把下一个任务丢给一个云端 subagent，它在自己的 VM 和分支上跑，你的本地工作区不被占用；/babysit 则让一个云端 agent 盯住某个 PR，回评论、解冲突、修挂掉的检查，直到它能合并。[^1]手机那头也接上了：iOS app（beta，官方公告称 public beta，各付费档可用）能从手机发起、跟进、直接合并 agent 的 PR；Remote Control 让你人在外面、继续指挥跑在你电脑上的那个 agent；Live Activities 把进度放在锁屏上。[^5]判断不变：手机适合查进度、批结果、给下一步指令，不适合当主工作台。 判断：陪你做的活留在眼前，做完通知的活派出去。它适合可并行、定义清楚、跑错能回滚的任务；不适合探索性的、你自己都没想清楚的改动 —— 那种你不在场，它容易产出一堆你没有心智模型、又得硬着头皮审的代码。它的 computer use 只在自己沙箱里（验证它造的东西），不碰你本机，这条线第 10 章再收。 **提示词 · Cloud Agent** ```text Cloud Agent 任务： 目标：<做成什么> 仓库/分支： 范围：只改 环境：运行 验收： - <测试命令必须通过> - 禁止：生产操作、读取 .env*、改权限、无测试大改。 完成后开 PR，并附日志 / 截图 / artifact。 ``` **示例** ```text Cloud Agent 任务： 目标：把所有日期格式从 MM/DD/YYYY 统一改成 ISO 8601（YYYY-MM-DD） 仓库/分支：acme/billing-service，base 分支 main 范围：只改 src/utils/date.ts 和 src/components/** 环境：运行 npm ci && npm run test:date 验收： - npm run test:date 必须全绿 - PR 描述必须列出风险和回滚（指出哪些展示位会变） 禁止：生产操作、读取 .env*、改权限、无测试大改。 完成后开 PR，并附日志 / 截图 / artifact。 ``` | 选择 | 适合 | 不适合 | |---|---|---| | 本地 Agent | 你要边看边改、随时打断、审每一步 | 长时间占机、可并行的任务 | | Cloud Agents | 明确、可回滚、跑完给 PR 的任务 | 敏感账号操作、无测试大改、探索性设计 | | Cursor CLI | 脚本、CI、headless review、非 IDE 场景 | 需要大量交互式 UI 判断的工作 | | Cursor SDK | 把 agent 编成你产品或流水线的部件：CI 修复机器人、批量任务、自定义工具 | 一次性的活、CLI 一行就能解决的活 | --- ### II · CLI 与自动化：无人值守地跑 能进脚本的 agent，才能在你睡觉时干活。 agent 把 agent 带进终端：`-p` 非交互、`--output-format json` 给结构化输出，可以塞进脚本和 CI / GitHub Actions；消息前加 `&`，任务就推给云端接着跑。[^2]Automations 则让云端 agent 按计划或事件自己触发 —— 事件面很宽：GitHub / GitLab / Bitbucket 的 PR 与评论、CI 跑完、Slack 消息（甚至指定一个表情当扳机）、webhooks、Linear。[^3]建一条也不再需要你会配：3.8 起在本地会话里 /automate，一句话描述要自动化什么，它替你配好触发器、指令和工具；自动化拉起的云端 agent 默认带 computer use，你可以直接在指令里要求它交一段 demo 录屏当作业。[^3]装上很简单，跑一个非交互任务也就一行： _装上 CLI，跑一个非交互任务（输出结构化 JSON）_ ```text ```bash curl https://cursor.com/install -fsS | bash agent -p "把 ./reports 下所有 csv 合并成 summary.csv 并去重" --output-format json ``` ``` **提示词 · Cursor CLI** ```text agent -p "<任务>" --model --mode agent --output-format json 约束： - 只改 - 不提交、不 push、不发 PR - 所有写入先生成 diff - 输出 JSON 包含 changedFiles、commandsRun、tests、risks。 ``` **示例** ```text agent -p "把 src/api 下所有 console.log 换成 logger.debug，并在文件顶部补上 logger 的 import" --model auto --mode agent --output-format json 约束： - 只改 src/api/** - 不提交、不 push、不发 PR - 所有写入先生成 diff - 输出 JSON 包含 changedFiles、commandsRun、tests、risks。 ``` - CI 里用 `CURSOR_API_KEY`，不要把 token 写进 workflow。 - 把 git commit / push / PR 评论放在确定性步骤，不一定交给 Agent。 - 用权限配置限制读写路径和 shell 命令。 - 失败要有日志、artifact、通知；成功也要有人 review。 边界：无人值守适合可验证、低风险、跑错能回滚的活 —— 定时整理数据、跑一份报告、批量处理文件。改动大、要判断、出错代价高的，别全自动；自动化的前提是「做完算什么样」你已经定死，机器只是去够这个标准。 - 无人值守禁止：生产部署、数据库迁移、账单 / 支付 / 钱包动作。 - 无人值守禁止：读取密钥、改 IAM、删除云资源、批量删除用户数据。 - 无人值守禁止：没有测试命令、没有日志、没有回滚办法的代码大改。 --- ### III · Bugbot：把机械评审那半交出去 PR review 里最累的是机械检查，这部分该交出去。[^4] Bugbot 在 GitHub / GitLab / Bitbucket 的 PR 上自动评审 diff，留下解释和修复建议，会读已有评论避免重复；效果分 Default / High / Custom 三档，usage-based 计费，也能用 `cursor review` / `bugbot run` 手动触发。[^4]它现在由 Cursor 自家的 Composer 2.5 驱动，官方称平均一次评审约 90 秒；推送前还能在本地 `/review` 先跑一遍 —— 开 PR 时 Bugbot 认得这份已审过的 diff，不再重复评审。[^4]它是「派出去」的一种形态：你不必盯着每个 PR 做那一遍机械扫描。 诚实的边界：它抓的是机械问题（bug、安全、规范），不替你判断设计意图和取舍。它替你看「这改得对不对」，你还得看「该不该这么设计」—— 意图层的 review 仍然是你的。把它当成给你省下第一遍粗筛的工具，不是替你拍板的评审者。 > 判断一件活该不该派出去，问一句：它有没有明确的「做完算什么样」、跑错了能不能回滚。两样都有，派；缺一样，留在眼前自己盯。并行派多个云端 agent 之前先想清楚你审不审得过来 —— 派出去的代码也得有人读。 --- ### IV · SDK：从用 agent 到编排 agent CLI 把 agent 放进脚本，SDK 把 agent 放进程序。 @cursor/sdk（TypeScript / Python）让你在自己的代码里调用同一个 agent：local runtime 跑在你的进程里、文件走本地磁盘，cloud runtime 跑在隔离 VM 里，一把 API key 通用。[^6]比 CLI 多出来的是「编排」的那层：把你自己的函数注册成它能调的工具（custom tools）；headless 跑时不必在「全放行」和「跑不动」之间二选一 —— 接 auto-review 分类器，用自然语言写哪些调用放行、哪些拦下；subagent 还能嵌套，审稿的可以再派一个写测试的。官方给的起点很说明定位：CI 自动修复机器人、bug 分诊、code review、嵌进你自己产品里的 agent。连云端 agent 的会话本身都能挂 hook（3.11 起有 prompt 提交前、响应后、subagent 启动等节点），拿来搭自纠错的循环。 判断：个人 builder 大多停在 CLI 就够 —— 一行命令、一条 automation，能覆盖绝大多数「派出去」的活。SDK 值得上的时刻只有一个：agent 不再是你手里的工具，而要成为你产品或流水线里的一个部件。到那一步，这一章讲的验收纪律不变，只是从「你审它的 PR」变成「你的程序审它的输出」。 把一件长跑或定时的活派出去一次： - **挑一件「做完通知我」的活**: 一个跨度较长、验收标准清楚的任务，编码或非编码都行（如定时整理一批数据 / 跑一份报告）。 - **交给 cloud agent，或写成一条 headless CLI 命令**: 然后离开 —— 去网页 / Slack 看它的进度，而不是守着它。 - **回收结果，决定它值不值得变成自动化**: 如果它跑得稳、你以后还会重复，就设条 Automation 让它按时间或事件自己跑。 > 陪你做的活留在眼前， > 做完通知的活派出去 ## 引用与参考 01 · Cursor Docs · Cloud Agents —— 原 Background Agents；每个 agent 一台隔离 VM、装完整开发环境，可随便并行，能在自己的桌面 / 浏览器里验证产出；发起入口：iOS app、cursor.com/agents 网页（Android 装 PWA）、桌面、Slack / Linear @cursor、GitHub / Bitbucket 评论 @cursor、API；本地会话里 /in-cloud 把下一个任务丢给云端 subagent，/babysit 让它盯 PR 到能合并。云端一律跑 Max Mode。截至 2026-07-10。 (Cursor Docs · Cloud Agents) 02 · Cursor Docs · CLI —— agent 把 agent 带到终端；-p 非交互，--output-format json / stream-json 结构化输出，可进脚本与 CI / GitHub Actions；支持 Plan / Ask 模式；消息前缀 & 即把任务推给 Cloud Agent 继续跑。截至 2026-07-10。 (Cursor Docs · CLI) 03 · Cursor Docs · Automations —— 让 Cloud Agents 按计划或事件运行，事件源含 GitHub、GitLab、Bitbucket、Slack（含表情触发）、webhooks、Linear 等；本地会话里用 /automate 一句话建自动化，Cursor 替你配触发器、指令与工具；computer use 对每条自动化默认开启，可要求它交 demo / artifact；自动化一律以 Max Mode 计费。截至 2026-07-10。 (Cursor Docs · Automations) 04 · Cursor Docs · Bugbot —— 在 GitHub / GitLab / Bitbucket 的 PR 上自动评审 diff，留下解释与修复建议；会读已有评论避免重复；效果档 Default / High / Custom；usage-based 计费；可用 cursor review / bugbot run 手动触发，推送前可在本地 /review 先跑。官方 changelog（2026-06-10）称 Bugbot 现由 Composer 2.5 驱动、平均评审约 90 秒。截至 2026-07-10。 (Cursor Docs · Bugbot) 05 · Cursor Docs · Cursor for iOS —— iOS app 处于 beta（changelog 称 public beta，2026-06-29 起），各付费档可用：从手机发起、跟进、合并云端 agent 的 PR，语音描述任务；Remote Control 从手机继续指挥跑在你电脑上的 agent（Teams / Enterprise 需管理员开启）；Live Activities 锁屏看进度；iPhone（iOS 26+）、英文界面，Android 计划中。截至 2026-07-10。 (Cursor Docs · iOS app) 06 · Cursor Docs · SDK（TypeScript / Python）—— @cursor/sdk 让你在自己的代码里调用 Cursor 的 agent：同一个 agent，local（在你的进程里、文件走本地磁盘）或 cloud（隔离 VM）两种 runtime，一把 CURSOR_API_KEY 通用；可把自己的函数注册成工具（custom tools）、headless 跑时接 auto-review 分类器管权限、subagent 可嵌套；官方给的起点是 CI 自动修复、bug 分诊、code review、嵌入产品的 agent 与编排器。截至 2026-07-10。 (Cursor Docs · SDK) --- *派出去 · Cloud Agents、CLI 与自动化 · Cursor · 一台元工具 · Aklman 著 · CC BY-NC-ND 4.0 · https://library.aklman.com/books/cursor/08-send-out*