> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 写好任务

> 给 Agent 布置任务的实用建议：说清目标和完成标准、提供上下文、拆分大任务、选对权限、自动化重复工作、让 Agent 提交 PR。

把任务写清楚，Agent 就能少走弯路、少停下来问你。下面这些建议适用于大多数会话。

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

告诉 Agent 要做成什么、改哪里、怎样算完成。比较一下：

* 「修一下登录页。」
* 「修复登录页在 Safari 下输入框错位的问题。只改登录页的样式，不动其他页面。完成后运行现有测试，并补一个覆盖 Safari 的测试。」

第二种写法给出了目标、边界和验收方式，Agent 不用猜，也知道什么时候该停下来交给你。

## 提供相关文件和链接

* **先选对项目**，Agent 才会在正确的代码和环境里工作。
* 在任务里写出相关的文件、目录、报错信息或文档链接。
* 界面问题直接附上截图，或用输入框的 **截取屏幕**；日志、设计稿等可以作为附件发送，见 [发起会话](https://docs.aihubmix.com/cn/cloud/sessions/start-a-session.md)。
* Agent 需要用到的密钥，提前保存到项目的密钥与环境变量里，免得它中途停下来向你要，见 [项目与环境配置](https://docs.aihubmix.com/cn/cloud/environments/projects.md)。

## 拆分大任务

一个会话专注一件事，效果通常更好。大需求可以拆成几个会话分别完成，比如先让 Agent 调研方案，再根据结论发起实现。

* 任务里有彼此独立的部分时，在任务中点明哪些可以并行。复杂任务里，Agent 可以派出 [子代理](https://docs.aihubmix.com/cn/cloud/sessions/subagents.md) 同时处理，全部完成后自动汇总结果。
* 想换一种做法试试，从某个回复 **分叉** 出新会话，原会话不受影响。
* Agent 走偏时，不必等它做完：用 **插话** 及时纠正，或修改之前的消息重新运行，见 [与 Agent 协作](https://docs.aihubmix.com/cn/cloud/sessions/work-with-agent.md)。

## 选对权限

新会话默认是 **完全访问**，Agent 不会为每一步来问你，适合在云主机上放手让它完成的任务。云主机上的会话从头到尾不经过你的电脑。

以下情况建议改用 **请求批准** 或 **替我批准**：

* 会话在你自己的电脑上执行，涉及重要文件或系统设置。
* 项目里有不希望 Agent 随意使用的密钥。完全访问下，Agent 可以读取本项目的全部密钥。
* 任务会连接外部服务或网站，你希望先确认再执行。

## 用定时任务处理重复工作

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

## 让 Agent 提交 PR

改动完成后，直接在会话里让 Agent 提交、推送或创建 PR，例如「测试通过后创建 PR，标题写清修复内容」。默认做法由项目设置里的提交方式决定，可以是创建 PR、推送分支，或按你写的提示词提交。没有关联远程仓库的上传项目，改动会以补丁交付。审阅改动和交付成果，见 [审阅与交付成果](https://docs.aihubmix.com/cn/cloud/sessions/review-and-deliver.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.