我想把 GitHub issue 交給 AI 開發代理在背景處理，自己只負責審 PR

我想把 GitHub issue 交給 AI 開發代理在背景處理，自己只負責審 PR的流程

1. 先替專案寫一份給代理看的說明檔

   在 repo 根目錄放一份 AGENTS.md（用 Claude Code 的話另外放 CLAUDE.md，內容可以共用），寫清楚：怎麼安裝相依套件、怎麼跑測試與 lint、資料夾各放什麼、命名與程式風格、哪些目錄不能動（例如自動產生的檔案、資料庫 migration）。可以先請 AI 讀過專案後起草，再由熟悉專案的人逐條修正。這份檔案寫得越具體，代理越少亂猜。

2. 把 issue 改寫成代理做得完的工單

   挑一個邊界清楚的 issue，把內容改寫成：背景一兩句、要改的範圍（哪些檔案或模組）、不要動的地方、驗收條件（例如『新增的測試通過、既有測試不壞、API 回傳格式不變』）、怎麼重現 bug。一張工單只放一件事。描述得模糊，代理就會照它自己的理解做一大包，審起來比自己寫還累。

3. 交給代理在背景做，先看計畫再放行

   依團隊習慣選工具：在 Jules 選 repo 與分支並貼上工單，或在 issue 加上 jules 標籤；在 Codex 指定 repo 交辦任務；用 Claude Code 的 GitHub Actions 時在 issue 裡呼叫它。代理列出計畫時先看一遍，範圍跑太大就當場縮回來。給代理的權限從最小開始，不要把正式環境的金鑰放進它能讀到的地方。

4. 用 AI 審查加人工驗收，才合併進主線

   PR 開出來後，先讓 CodeRabbit 這類 AI 程式碼審查工具掃一輪，抓出明顯的錯誤與漏掉的邊界情況，再由人對照工單的驗收條件逐條確認，並在本機或預覽環境實際跑一次。代理宣稱『測試都過了』，請自己看 CI 結果。審查時發現的共通問題，回頭補進 AGENTS.md，下一張工單就會少犯一次。