給編碼 Agent 先喂 2000 Token 專案地圖

2026-11-01 09:01，DEV Community 的 AI 專欄發表了一位作者的文章，題為《老倉庫先給 Agent 一份 2000 Token 專案地圖》。文章建議，在給編碼 Agent 下達第一個任務前，先用幾條命令生成一份約 2000 Token 的專案地圖，把目錄結構、測試目錄位置等原本需要 Agent 自己摸索的資訊直接交給它。

文章描述了一個場景：開啟一個有十年曆史的 PHP 應用，啟動編碼 Agent，輸入「add a refund endpoint」，Agent 會列出根目錄、讀 composer.json、搜尋 Controller，開啟三個最終發現是死檔案的檔案，又找到第二個無人執行的 tests/ 資料夾，之後才能開始幹活。作者認為，這樣能避免 Agent 在每個新會話裡重複遍歷這個十年老倉庫，把上下文視窗浪費在死檔案和沒人執行的測試上。

這篇文章的作者還寫了《Decoupled PHP — Clean and Hexagonal Architecture for Applications That Outlive the Framework》《Thinking in Go》（2 冊系列，含《Complete Guide to Go Programming》和《Hexagonal Architecture in Go》），維護著一個名為 Hermes IDE 的專案，定位是為使用 Claude Code 及其他 AI 編碼工具的開發者服務的 IDE，站點是 xgabriel.com。