別再堆AGENTS.md了：一篇掘金長文的前端AI Coding工程化主張回顧

2026年9月7日，掘金作者LEE刊出長文「別再堆AGENTS.md了：前端團隊如何把AI Coding做成一套可執行的工程系統」，全文約九分鐘閱讀長度，聚焦一個具體問題：前端團隊應該如何為Coding Agent分層組織上下文，讓它既能理解任務，又不會被無關資訊淹沒。截至文章頁面顯示的統計，該文閱讀量為一百八十次。本臺以回顧角度，整理文中可核實的主張輪廓、引用的技術脈絡，以及與近期前端社羣討論的對照。

文章的核心觀察：一份什麼都寫的檔案，最後什麼都沒管好

作者描述了許多團隊使用AI Coding一段時間後的共同經歷：在專案根目錄加上一份AGENTS.md，然後不斷往裡面補規則。起初只有幾十行，寫程式碼風格、測試命令和目錄約定；後來陸續加入介面說明、業務背景、發布流程、歷史踩坑與常見任務模板；最終檔案膨脹到數百行。

作者的判斷是，Agent表面上看起來知道很多事情，實際執行時仍會出現幾類失誤：漏掉必須呼叫的介面；把已失效的約定當成當前規則；知道應該先確認，卻仍直接執行寫入操作；生成看似合理、卻沒有通過專案品質門禁的程式碼。

文章對成因的解釋是：問題通常不在模型變笨，而在於把不同生命週期、不同可信等級、不同執行方式的資訊，混進了同一個上下文容器。作者以一句比喻概括對AGENTS.md的定位：它不是Agent的大腦，更像是它的憲法。

引用來源：Anthropic的context rot概念

文中最具體的外部引用，是Anthropic發布的「Effective context engineering for AI agents」一文。LEE引用其中提出的context rot概念：上下文不斷變長，並不意味有效資訊持續增加；相反，無關內容與過時內容會稀釋真正重要的訊號。

這一引用構成文章的理論支點。作者據此強調「生命週期」是最容易被忽略的維度：專案規則可能幾個月才變一次，當前任務的規格幾天後就失效，某次任務產生的臨時上下文在任務結束後應直接丟棄。三者若共用一份常駐檔案，模型不僅要花注意力區分資訊，還得自行判斷哪些內容已經過期。

職責拆分：文中提出的歸屬對照

文章用一張對照表說明，一份臃腫的AGENTS.md通常同時承擔了五類職責，而每類職責各有更合適的歸屬。

第一類是Agent的角色、邊界與不可違反的規則，回答「你是誰、什麼不能做」，歸屬仍是AGENTS.md或CLAUDE.md。第二類是當前需求、範圍與驗收標準，回答「這次任務要完成什麼、怎樣算完成」，歸屬是Spec。第三類是專案架構、介面、術語與目錄知識，回答「這個專案是什麼」，歸屬是Wiki或Reference文件。第四類是重複執行的步驟，以及查詢、修改、發布等平臺操作，回答「這類任務具體怎麼做、如何安全地碰外部系統」，歸屬是Skill搭配CLI或MCP工具。第五類是測試、Code Review、審計與人工確認，回答「如何證明做對了」，歸屬是CI與Review門禁。

五層結構的具體內容

在職責拆分的基礎上，作者把Coding Agent的工作環境描述為一套分層系統。

AGENTS.md這一層適合放三類內容：Agent在此倉庫中的角色；必須遵守的安全與協作邊界；入口級的工作約定，例如修改後必須執行哪些檢查。作者給出一個判斷標準：如果某條內容只對某一次任務有效，就不該寫進常駐的AGENTS.md。

Spec這一層被定位為「當前任務的合同」，負責把「幫我做一下」轉成可執行的任務邊界，內容包括背景與目標、允許修改的檔案範圍、完成判準、必須先確認的行為，以及需要留下的驗證證據。作者強調Spec不是需求文檔的另一種格式，而是Agent與人共同使用的當前任務合同，任務結束後可歸檔、提煉或直接丟棄。

Wiki這一層承載長期知識，包括架構說明、介面語意、術語定義、歷史決策與經過驗證的踩坑經驗，但作者劃出一條界線：知識庫回答「專案是什麼、為什麼這樣設計」，Skill才回答「這類任務具體怎麼做」，兩者混在一起，知識會變成一份沒人敢改的操作手冊。

Skill這一層承載有明確輸入、步驟與輸出的任務，文舉的例子包括：檢查頁面是否符合專案路由約定、按固定格式生成介面聯調清單、對變更執行測試與風險檢查、先dry-run再生成待確認的變更計畫。作者認為Skill的價值在於固定穩定的動作順序，同時把需要臨時檢索的知識留在外部。

CLI與MCP這一層處理操作能力的邊界。作者的表述是：Agent能理解「請把配置改成X」，不代表它應該擁有一把可以直接寫入生產系統的鑰匙；查詢、修改、發布等動作應經過有明確契約的CLI或MCP工具。這一思路與瀏覽器端正在孵化的WebMCP標準方向一致：讓智慧體的工具呼叫有可宣告、可約束的介面，而非依賴自由操作。

社羣脈絡對照

這篇文章刊出的時間點，正值AI輔助前端創作與工程化的討論在中文技術社羣持續流傳的階段。此前V2EX上曾有貼文稱有人以Codex在半小時內做出遊戲型態的個人主頁，本臺先前整理過該則AI前端快速創作貼文的輪廓。兩相對照，可以看見同一批工具的兩種討論面向：一種聚焦生成速度與成品樣態，另一種聚焦團隊如何在日常工程中讓這些工具穩定交付。LEE的文章明顯屬於後者，其出發點不是展示AI能做到什麼，而是組織資訊讓Agent可靠地做到該做的事。

可核實邊界

需要說明的是，文中關於五層結構的內容屬於作者的工程主張，而非有官方規範背書的標準作法。AGENTS.md本身是社羣與部分工具廠商採用的約定檔案，各家工具的支援程度與讀取行為不盡相同；文末的表格與清單均轉述自該篇掘金文章，未經第三方工程實測驗證。文內引用的Anthropic文章為真實存在的公開文檔，其context rot論述與LEE的轉述方向一致，但原始定義以Anthropic原文為準。

截至本臺整理時，該文閱讀量為一百八十次，屬於剛刊出不久的長文，其主張在社羣的實際採用情形與後續討論仍有待觀察。對於正在為團隊建置AI Coding流程的前端工程師而言，這篇文章提供的是一套可辯論的分層框架，而非定論；各層之間的邊界劃分，仍需按專案規模與團隊工作流自行檢驗。