DEV 文章主張用 10 個 Makefile 目標充當編碼 Agent 的倉庫說明書

2026 年 11 月 3 日 03:01，DEV Community · AI 釋出了一篇題為《給編碼 Agent 的 Makefile：每個倉庫必備的 10 個目標》的文章，作者是 Go 程式設計書籍《Thinking in Go》（兩卷本系列，含《Complete Guide to Go Programming》與《Hexagonal Architecture in Go》）的作者，他還維護著一個面向使用 Claude Code 及其他 AI 編碼工具的開發者的專案 Hermes IDE，並著有《Database Playbook》。文章主張用 Makefile 充當編碼 Agent 的倉庫說明書，列出 Agent 動手前每個倉庫應具備的 10 個 make 目標，把測試、資料庫重置這類 Agent 猜不準的命令固定下來。

文章從一處具體觀察切入：把一個失敗測試交給編碼 Agent，放進它從未見過的倉庫，看它的前幾步讀什麼——它讀 package.json，讀仍提到有人已刪掉的指令碼的 README，開啟 CI 檔案弄清究竟跑什麼，然後猜測，而出錯的地方就在猜測這一步。文章引用 Anthropic 的 Claude Code 最佳實踐指出，沒有可執行的檢查時，「看起來做完了」就是唯一訊號，因此需要通過上述 make 目標來消除猜測。文中提到這套寫法可以直接搬進自己的倉庫。這是該議題目前唯一的報道。