10分钟快速上手将agent-rules-books接入Claude Code、Cursor与Codex的完整教程【免费下载链接】agent-rules-booksAGENTS.md rules / skills for AI coding agents: Codex, Cursor Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.项目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-booksagent-rules-books是一个为 AI 编码智能体提供现成规则与技能Skills的开源项目覆盖Codex、Cursor 和 Claude Code三大主流工具。它把《Clean Code》《Refactoring》《Clean Architecture》《DDD》《DDIA》等 14 本经典软件工程著作提炼成可直接使用的 AGENTS.md 规则集。本文是一份面向新手的完整教程带你 10 分钟内完成接入。agent-rules-books 是什么为什么需要它让 AI 写代码不难难的是让 AI 写得像你团队希望的那样。你当然可以在提示词里写一句请遵守《重构》原则但 AI 对书名的理解往往是浮于表面的。agent-rules-books 的思路是把每本书中的决策规则、触发条件和检查清单显式写成 Markdown 规则文件让 AI 在生成、重构、评审代码时真正照着做。它有三个特点对新手特别友好开箱即用14 个规则集全部是纯 Markdown 文件复制即用无需安装任何依赖按工具适配官方提供了 Codex、Claude Code、Cursor 各自的接入指南docs/USAGE.md有据可查每本书的目录下都附带traceability.md说明每条规则出自原著哪部分30秒看懂mini、nano、full 三个版本怎么选每个规则集都有三个版本这是新手最容易困惑的地方记住下面的表格即可版本定位什么时候用mini推荐起步日常任务的主力版本默认选择作为技能Skill或项目级基线nano极简版约 2KB上下文预算非常紧张或需要跨工具共享的超小基线full完整参考版深度审计、一次性高强度会话、作为技能的参考文件官方给出的核心原则是从最小的、能改变 AI 决策的机制开始。多数场景下一个mini就足够了。以《Clean Code》为例三个版本分别是clean-code.mini.md约 40 行含决策规则 触发规则 检查清单clean-code.nano.md约 30 行clean-code.md完整参考版接入步骤一获取规则文件两种方式任选其一。方式 A直接浏览并复制你需要的规则文件推荐新手仓库按书名组织目录例如《重构》在 refactoring/ 目录《实用程序员》在 the-pragmatic-programmer/ 目录。找到合适版本的.md文件复制内容到你项目里即可。方式 B克隆仓库git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books.git建议只复制需要的规则文件到你的项目不要把整个仓库当作项目的一部分——它只是规则素材库。接入步骤二Codex 最快配置方法Codex 原生读取AGENTS.md接入最简单两步走项目级基线把选好的mini规则内容放进项目根目录的AGENTS.md或子目录按需放置技能Skill把书专属的工作流做成技能放入.agents/skills/推荐的项目结构project/ AGENTS.md # 一个 mini 规则集作为全局基线 .agents/ skills/ refactoring-pass/ SKILL.md # 来自 refactoring.mini.md官方推荐的 refactoring.mini.md 就是很好的技能起点它明确要求 AI小步走、保持行为不变、先建安全网再动刀——这正是新手最怕 AI 一上来就大改代码的问题。⚠️ 避免把多个full文件全局加载那会挤占宝贵的上下文。接入步骤三Claude Code 一键导入 AGENTS.mdClaude Code 的记忆入口是CLAUDE.md官方推荐短根记忆 按需扩展的模式保持根目录CLAUDE.md尽量短用一行AGENTS.md导入共享基线实现跨工具一份规则、多处复用project/ AGENTS.md # 共享的 mini 规则基线 CLAUDE.md # 内容AGENTS.md 少量 Claude 专属说明 .claude/ rules/ # 子系统级规则 skills/ review-pass/ SKILL.md # 来自某个 mini 规则集书专属流程做成技能例如把 release-it.mini.md 放进.claude/skills/只在处理生产可靠性问题时才被加载这个模式的好处Claude Code 和 Codex 共用同一份AGENTS.md基线规则只需维护一次。接入步骤四Cursor 规则文件配置技巧Cursor 最强的原生机制是.cursor/rules/*.mdc项目规则推荐一个短基线 多个主题规则的拆分project/ .cursor/ rules/ base.mdc # 唯一的 Always 规则来自某个 mini必须保持短小 payments.mdc # Auto Attached仅对 payments/** 目录生效 refactor.mdc # Manual重构时手动 Cursor Rules 调用 ddd.mdc # Agent Requested领域建模任务时按需加载新手常见误区是把所有规则塞进一个巨型Always规则里。正确做法是最多一个项目级 Always 规则用 mini 或 nano其余按目录或任务类型拆分用Cursor Rules显式调用。简单项目也可以直接用根目录AGENTS.md兜底。多本书怎么选先看兼容性矩阵想同时加载多本书时先查官方的兼容性矩阵docs/COMPATIBILITY.md它用三种标记告诉你两本书能否同时作为活跃规则✅ 互补可以放心组合 重叠二选一即可如《重构》与《Refactoring.Guru》❌ 冲突不要同时加载如 DDD 与《企业应用架构模式》决策口诀来自 docs/USAGE.md你的需求推荐做法某个任务需要特定书的视角从对应mini创建技能按需调用想要稳定的全仓库工程基调只用一个mini作为项目基线上下文预算极紧用nano需要大篇幅参考资料交给检索 / MCP不要塞进常驻提示词常见问题 FAQQ1这些规则是书的官方内容吗不是。它们是受原著启发的工程指令用于约束 AI 行为不是书籍摘要也不能替代读原书详见 README 中的说明。Q2mini 和 nano 差距多大nano 约 2KB只保留最核心的倾向性提醒mini 通常 4~8KB包含完整的决策规则、触发规则与检查清单能真正改变 AI 的实现选择。日常用 mini 即可。Q3规则文件会随工具更新吗每个规则集都附带traceability.md如 refactoring/traceability.md记录规则与书籍结构的对应关系版本历史见 CHANGELOG.md。总结agent-rules-books 的接入门槛极低选一个mini规则集 → 放进对应工具的规则入口 → 书专属流程做成技能。Codex 用AGENTS.md最省事Claude Code 用AGENTS.md导入实现跨工具复用Cursor 用.cursor/rules做精细作用域控制。先从一本书、一个 mini 起步等 AI 的代码风格稳定后再按兼容性矩阵逐步叠加更多规则集。【免费下载链接】agent-rules-booksAGENTS.md rules / skills for AI coding agents: Codex, Cursor Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.项目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-books创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考