用 AGENTS.md 給 AI 編碼代理寫專案簡報

2026 年 11 月 10 日，DEV Community 網站 AI 欄目刊出一篇文章，題為《用 AGENTS.md 給 AI 編碼代理寫專案簡報》。作者介紹自己使用 AI 編碼代理開發 Yonto Player，一款 Android TV、手機和平板上的個人媒體庫播放器。

作者提到，AI 編碼代理在每個會話開始時對這個倉庫一無所知，所以它在會話中最先讀到的內容，會很大程度上決定它接下來做什麼，而這個最先讀到的東西就是位於倉庫根目錄的 AGENTS.md，作者在該檔案上投入的時間幾乎超過任何其他檔案。文中提到這是系列文章的一篇，系列開篇帖曾展示過這個檔案的大致模樣，本文更進一步展開：什麼內容該放進根檔案，什麼內容該留在外面，以及它該怎麼寫。

作者的做法是借 AGENTS.md 與 AI 編碼代理建立一份契約，回答四個問題：專案是什麼、程式碼如何組織、做完之後如何驗證、以及哪些現有結構不能破壞；根檔案只保留幾乎所有任務都會用到的簡報，任務專屬的細節放到更深層的文件裡，並在根檔案中指明這些位置所在。目前材料只見到這一篇文章，其細節未見其他報道補充。