Repo Agent（程式庫代理）

能讀整個專案、自己跨檔案改程式、跑指令與驗證，再整理結果回報的 AI 代理。

先用一句話理解

英文全名：Repository / Terminal Agent

能讀整個專案、自己跨檔案改程式、跑指令與驗證，再整理結果回報的 AI 代理。

打個比方

像把任務交給一位工程代理人：你說清楚要什麼，他自己翻遍專案、動手改、跑測試，再回報讓你驗收。

什麼時候會遇到

任務需要讀整個 codebase、改很多檔、修 bug，或跑 lint/typecheck/build、處理錯誤訊息時。

再往深一點看

Repo agent（也叫 terminal agent）例如 Claude Code、OpenAI Codex、Devin、Aider。它和 AI IDE 最大的差別是「誰在駕駛」：AI IDE 是你開著編輯器、AI 從旁協助；repo agent 是你給一段有目標和驗證標準的任務，它自己讀專案、跨多個檔案修改、執行指令、回報 diff。它很適合跨檔案的 bug 修正與重複性工程工作，但不適合需求還很模糊的產品探索，也不該「不 review 就直接上線」——你仍要看它的 diff 與驗證結果。

舉個例子

你把一個 bug 交給 Claude Code，附上錯誤訊息、重現步驟和期待結果，要求它修好後跑 npm run typecheck、lint、build。它讀相關檔案、定位原因、跨兩三個檔案修改，最後回報改了哪些檔案與驗證結果，你 review diff 後才合併。

常見誤解

- 只說「壞掉了」就丟給 agent——沒有重現步驟和期待結果，它會猜錯方向。
- 沒有要求它跑驗證指令（typecheck/lint/build），拿到一段沒驗證過的改動就直接相信。
- 一次委派多個又大又模糊的任務，產出多到自己根本無法 review。