> ## 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/zh-Hant/cloud/sessions/start-a-session.md)。
* Agent 需要用到的金鑰，提前儲存到專案的金鑰與環境變數裡，免得它中途停下來向你要，見 [專案與環境配置](https://docs.aihubmix.com/zh-Hant/cloud/environments/projects.md)。

## 拆分大任務

一個會話專注一件事，效果通常更好。大需求可以拆成幾個會話分別完成，比如先讓 Agent 調研方案，再根據結論發起實現。

* 任務裡有彼此獨立的部分時，在任務中點明哪些可以並行。複雜任務裡，Agent 可以派出 [子代理](https://docs.aihubmix.com/zh-Hant/cloud/sessions/subagents.md) 同時處理，全部完成後自動彙總結果。
* 想換一種做法試試，從某個回覆 **分叉** 出新會話，原會話不受影響。
* Agent 走偏時，不必等它做完：用 **插話** 及時糾正，或修改之前的訊息重新執行，見 [與 Agent 協作](https://docs.aihubmix.com/zh-Hant/cloud/sessions/work-with-agent.md)。

## 選對許可權

新會話預設是 **完全訪問**，Agent 不會為每一步來問你，適合在雲主機上放手讓它完成的任務。雲主機上的會話從頭到尾不經過你的電腦。

以下情況建議改用 **請求批准** 或 **替我批准**：

* 會話在你自己的電腦上執行，涉及重要檔案或系統設定。
* 專案裡有不希望 Agent 隨意使用的金鑰。完全訪問下，Agent 可以讀取本專案的全部金鑰。
* 任務會連線外部服務或網站，你希望先確認再執行。

## 用定時任務處理重複工作

需要定期做的事，例如「每個工作日早上 9 點檢查依賴更新」，直接在會話裡用自然語言告訴 Agent。它會起草一個定時任務，你點選 **建立** 後才會生效。跟當前會話相關的跟進，例如「30 分鐘後再檢查一次部署」，可以讓 Agent 設定會話定時。定時任務在雲主機上執行，關掉電腦也照常執行，見 [定時任務](https://docs.aihubmix.com/zh-Hant/cloud/automation/scheduled-tasks.md)。

## 讓 Agent 提交 PR

改動完成後，直接在會話裡讓 Agent 提交、推送或建立 PR，例如「測試透過後建立 PR，標題寫清修復內容」。預設做法由專案設定裡的提交方式決定，可以是建立 PR、推送分支，或按你寫的提示詞提交。沒有關聯遠端倉庫的上傳專案，改動會以補丁交付。審閱改動和交付成果，見 [審閱與交付成果](https://docs.aihubmix.com/zh-Hant/cloud/sessions/review-and-deliver.md)。


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