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

# 程式碼品質規則集（mini 版・改寫自 agent-rules-books / Clean Code 為例）

你在本專案產生、審查或重構程式碼時，請遵守下列規則。將本段貼入 {{AGENT_FILE}}（如 AGENTS.md / CLAUDE.md / .cursorrules）。

## 何時套用
撰寫新程式、審查 PR、或重構既有程式碼時皆適用。

## 首要修正的偏誤
優先消除：含糊命名、過長且混雜多層抽象的函式、隱藏的副作用、用註解去解釋本該寫清楚的爛 code。

## 決策規則
- 保留既有行為，為「下一個讀者」而寫，在你動到的範圍內讓程式更乾淨（童子軍規則）。
- 用精準命名、一個概念只用一個詞；讓程式能被局部推理（不必跳全檔才看懂）。
- 把布林旗標、混雜的抽象層級、隱藏副作用從函式裡拆出去。
- 命令（會改狀態）與查詢（只回傳值）分離；參數量保持精簡且有意義。
- 讓 happy path 清楚可讀；把無效狀態、錯誤與清理顯式化，而非藏在隱性流程裡。
- 註解只用來說明「為什麼／合約」，不要用來解釋讓人看不懂的程式。

## 觸發規則
- 當一個函式既改狀態又回傳答案 → 拆成兩個。
- 當你需要寫註解解釋流程 → 先把程式簡化到不需要那條註解。

## 最終檢查清單
- [ ] 命名是否精準、單一概念單一詞？
- [ ] 函式是否只做一件事、抽象層級一致？
- [ ] 有無隱藏副作用或命令／查詢混用？
- [ ] 錯誤與邊界是否顯式處理？

（依需求可換成其他書：refactoring、domain-driven-design、the-pragmatic-programmer、working-effectively-with-legacy-code 等；每本都有 full／mini／nano 三尺寸。）

---
📎 來源：ciembor/agent-rules-books（MIT 授權）— 本篇為繁中改寫整理，規則措辭已重寫、非逐字照搬，原始 14 本書的完整規則集與三種尺寸見上方連結。

把方括號 [ ] 內的變數換成你的內容，丟進 Claude Code。

# 程式碼品質規則集（mini 版・改寫自 agent-rules-books / Clean Code 為例）

你在本專案產生、審查或重構程式碼時，請遵守下列規則。將本段貼入 {{AGENT_FILE}}（如 AGENTS.md / CLAUDE.md / .cursorrules）。

## 何時套用
撰寫新程式、審查 PR、或重構既有程式碼時皆適用。

## 首要修正的偏誤
優先消除：含糊命名、過長且混雜多層抽象的函式、隱藏的副作用、用註解去解釋本該寫清楚的爛 code。

## 決策規則
- 保留既有行為，為「下一個讀者」而寫，在你動到的範圍內讓程式更乾淨（童子軍規則）。
- 用精準命名、一個概念只用一個詞；讓程式能被局部推理（不必跳全檔才看懂）。
- 把布林旗標、混雜的抽象層級、隱藏副作用從函式裡拆出去。
- 命令（會改狀態）與查詢（只回傳值）分離；參數量保持精簡且有意義。
- 讓 happy path 清楚可讀；把無效狀態、錯誤與清理顯式化，而非藏在隱性流程裡。
- 註解只用來說明「為什麼／合約」，不要用來解釋讓人看不懂的程式。

## 觸發規則
- 當一個函式既改狀態又回傳答案 → 拆成兩個。
- 當你需要寫註解解釋流程 → 先把程式簡化到不需要那條註解。

## 最終檢查清單
- [ ] 命名是否精準、單一概念單一詞？
- [ ] 函式是否只做一件事、抽象層級一致？
- [ ] 有無隱藏副作用或命令／查詢混用？
- [ ] 錯誤與邊界是否顯式處理？

（依需求可換成其他書：refactoring、domain-driven-design、the-pragmatic-programmer、working-effectively-with-legacy-code 等；每本都有 full／mini／nano 三尺寸。）

---
📎 來源：ciembor/agent-rules-books（MIT 授權）— 本篇為繁中改寫整理，規則措辭已重寫、非逐字照搬，原始 14 本書的完整規則集與三種尺寸見上方連結。