跳转到主要内容
把任务写清楚,Agent 就能少走弯路、少停下来问你。下面这些建议适用于大多数会话。

说清目标、范围和完成标准

告诉 Agent 要做成什么、改哪里、怎样算完成。比较一下:
  • 「修一下登录页。」
  • 「修复登录页在 Safari 下输入框错位的问题。只改登录页的样式,不动其他页面。完成后运行现有测试,并补一个覆盖 Safari 的测试。」
第二种写法给出了目标、边界和验收方式,Agent 不用猜,也知道什么时候该停下来交给你。

提供相关文件和链接

  • 先选对项目,Agent 才会在正确的代码和环境里工作。
  • 在任务里写出相关的文件、目录、报错信息或文档链接。
  • 界面问题直接附上截图,或用输入框的 截取屏幕;日志、设计稿等可以作为附件发送,见 发起会话。
  • Agent 需要用到的密钥,提前保存到项目的密钥与环境变量里,免得它中途停下来向你要,见 项目与环境配置。

拆分大任务

一个会话专注一件事,效果通常更好。大需求可以拆成几个会话分别完成,比如先让 Agent 调研方案,再根据结论发起实现。
  • 任务里有彼此独立的部分时,在任务中点明哪些可以并行。复杂任务里,Agent 可以派出 子代理 同时处理,全部完成后自动汇总结果。
  • 想换一种做法试试,从某个回复 分叉 出新会话,原会话不受影响。
  • Agent 走偏时,不必等它做完:用 插话 及时纠正,或修改之前的消息重新运行,见 与 Agent 协作。

选对权限

新会话默认是 完全访问,Agent 不会为每一步来问你,适合在云主机上放手让它完成的任务。云主机上的会话从头到尾不经过你的电脑。 以下情况建议改用 请求批准 或 替我批准:
  • 会话在你自己的电脑上执行,涉及重要文件或系统设置。
  • 项目里有不希望 Agent 随意使用的密钥。完全访问下,Agent 可以读取本项目的全部密钥。
  • 任务会连接外部服务或网站,你希望先确认再执行。

用定时任务处理重复工作

需要定期做的事,例如「每个工作日早上 9 点检查依赖更新」,直接在会话里用自然语言告诉 Agent。它会起草一个定时任务,你点击 创建 后才会生效。跟当前会话相关的跟进,例如「30 分钟后再检查一次部署」,可以让 Agent 设置会话定时。定时任务在云主机上运行,关掉电脑也照常执行,见 定时任务。

让 Agent 提交 PR

改动完成后,直接在会话里让 Agent 提交、推送或创建 PR,例如「测试通过后创建 PR,标题写清修复内容」。默认做法由项目设置里的提交方式决定,可以是创建 PR、推送分支,或按你写的提示词提交。没有关联远程仓库的上传项目,改动会以补丁交付。审阅改动和交付成果,见 审阅与交付成果。