ciembor/agent-rules-books

What it solves

它提供了一個為 AI 編碼代理程式（例如 Cursor, Claude Code, 和 Codex）準備好的、隨即可用的規則集與「技能」庫，以確保它們遵循既定的軟體工程原則。這個專案不只是簡單地告訴代理程式「遵循 Clean Code」，而是提供具體的、提煉出的指令，防止代理程式在重構與開發過程中做出錯誤的架構決策或忽略產業標準的設計模式。

How it works

本專案將經典軟體工程書籍（例如 Clean Code, Domain-Driven Design, Refactoring）的核心原則提煉成與工具無關的 Markdown 檔案。這些規則提供三種尺寸，以平衡細節與上下文窗口（context window）限制：

• Full: 完全參考版本。
• Mini: 大多數任務的推薦版本。
• Nano: 針對極度受限的上下文預算（context budgets）的精簡版本。

使用者可以透過 CLI 工具 (npx skills) 安裝這些規則作為「技能」，或是手動將它們加入專案特定的指令檔案，例如 AGENTS.md 或 CLAUDE.md。

Who it’s for

使用 AI 編碼助手的使用者，且希望其代理程式能根據已證實的架構模式，而非僅僅依賴代理程式的預設（且有時不一致）行為，來產出更高品質、更具可維護性的程式碼。

Highlights

• Comprehensive Library: 涵蓋了廣泛的領域，包括 DDD, Clean Architecture, legacy code handling, 和 data-intensive systems。
• Context-Aware Sizing: 提供不同的規則密度（Full, Mini, Nano）以優化 token 使用量。
• Tool Agnostic: 相容於主要的 AI 編輯器與代理程式，包括 Cursor, Claude Code, Codex, 和 GitHub Copilot。
• Empirically Tested: 包含一個驗證實驗，顯示提供具體的規則比起單純命名一本著作，能顯著提升代理程式的架構判斷力。