回到所有文章
AI × 開發實戰

給 Coding Agent 的上下文,該放什麼?

整理專案慣例、任務邊界與驗收條件,減少 AI 在錯誤方向上努力的機會。

與 Coding Agent 合作時,上下文的品質經常比長度更有影響。不是把整個專案貼進對話,而是提供目前任務需要的資訊。

穩定資訊與任務資訊分開

穩定的專案資訊可以放在儲存庫文件中,例如啟動方式、目錄結構、測試指令與程式風格。隨任務變動的內容,則寫在當次要求裡:背景、修改範圍與驗收條件。

這樣做可以避免文件不斷堆疊過期的需求,也讓新任務更容易開始。

最值得提供的三種資訊

專案中的既有做法

指出一個最接近的元件、資料流程或文章格式,往往比口頭描述十條規則更有效。要求沿用現有慣例,並說明哪些差異是刻意的。

明確的修改邊界

例如「只調整文章列表,不更換內容儲存方式」或「可以新增依賴,但要說明必要性」。邊界讓實作更容易審查。

可觀察的驗收結果

避免只寫「要好用」。改成「手機上能操作分類」、「搜尋沒有結果時可以重設」或「重新開啟分享網址後仍保留篩選」。

給上下文,也保留查證空間

文件不可能永遠完整。好的指示應允許 Agent 先讀取現況、指出矛盾,再依證據實作。當文件和程式不同時,讓差異浮上檯面,比繼續累積猜測更有價值。

一次只改善一個地方

下一個任務可以試著補上一個相關檔案位置,或一句具體的驗收條件。觀察它是否減少重做,再逐步形成適合自己專案的合作方式。

W.

Will

一個軟體工程師的 AI、開發與成長筆記。
Always learning. Always building.

關於作者