agent-rules-books：把 Clean Code／重構／DDD 等經典蒸餾成 AGENTS.md 規則（full／mini／nano 三版）

光在 AGENTS.md 寫「請遵守 Clean Code」沒用——AI 不會照辦。這個專案把 14 本經典拆成一條條可執行的祈使規則（含 mini／nano 省 token 版），貼進去，AI 的命名、函式切分、重構時機才真的有依據。

[ Log in to see the full prompt ]

## 這是什麼／解決什麼痛點 agent-rules-books 把多本軟體工程經典「蒸餾」成給 AI 編碼代理用的規則集。痛點在於：你在 AGENTS.md / CLAUDE.md 裡只寫一句「請遵守 Clean Code」，AI 幾乎不會真的照做——光點名一本書，效果遠不如給它一條條具體、可執行的指令。這個專案就是把書中原則抽成**祈使句規則**（如「函式既改狀態又回傳答案就拆開」「註解只寫為什麼、不解釋爛 code」），讓代理在產碼、審查、重構時有明確依據。 ## 為什麼這個來源值得用 MIT 授權可自由使用修改；涵蓋面廣，目前蒸餾了 14 本重量級經典，包含：A Philosophy of Software Design、Clean Architecture、Clean Code、Code Complete、Designing Data-Intensive Applications、Domain-Driven Design（含 Distilled 與 Implementing 兩本）、Patterns of Enterprise Application Architecture、Refactoring、Release It!、The Pragmatic Programmer、Working Effectively with Legacy Code，以及 Refactoring.Guru。作者也說明：實測「規則化引導」在設計品質上明顯優於只丟書名。 ## full／mini／nano 三版差異 每本書都提供三種尺寸，對應不同 context 預算： - **full**：完整版（約 300+ 行、150+ 條規則），要最完整覆蓋時用。 - **mini**：推薦的日常生產版（約 45–65 行、28–47 條），完整度與精簡的平衡點，官方建議多數情況用這版。 - **nano**：極度壓縮的後備版（約 32–44 行、14–26 條），context 很吃緊時用。 三版共享同一套核心原則，只是逐級壓縮。 ## 怎麼用（步驟） 1. 到倉庫挑你要的書目錄（如 clean-code、refactoring、domain-driven-design）。 2. 每個目錄內有三個檔：`書名.md`（full）、`書名.mini.md`、`書名.nano.md`。 3. 依你的 context 預算選一版，**手動複製**內容貼進專案的 AGENTS.md、CLAUDE.md、Cursor rules 或 Copilot instructions（沒有自動安裝腳本）。 4. 可混搭多本（例如同時放 Clean Code mini + Refactoring nano）。 ## 何時用 當你希望 AI 在這個 repo 裡長期維持某種設計品味（乾淨命名、合理重構時機、DDD 邊界）時，把對應規則釘進代理設定檔即可一勞永逸；上方 full_prompt 即以 Clean Code mini 版為例、改寫成可直接貼用的繁中規則段。 📎 來源：ciembor/agent-rules-books（MIT 授權）— 本篇為繁中改寫整理、規則措辭已重寫，原始內容見 source_url。