Codex玩转agent-rules-books：AGENTS.md与.agents/skills双层配置的完整指南

Codex玩转agent-rules-booksAGENTS.md与.agents/skills双层配置的完整指南【免费下载链接】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 是一个把《Clean Code》《Refactoring》《Domain-Driven Design》等14本经典编程书籍提炼成 AI 编码智能体规则的开源项目专为 Codex、Cursor 和 Claude Code 提供开箱即用的 AGENTS.md 规则与 .agents/skills 技能包帮你用最小配置让 AI 写出更专业的代码。为什么需要 agent-rules-books直接让 AI 写代码常见问题是代码能跑但结构混乱、命名随意、重构失控。项目作者在 README.md 中做过一个对比实验对同一个应用分别用「仅提到书名」和「加载 mini 版规则」两种方式让 Codex 做重构结果加载规则的版本评分约 74 分仅提书名仅 46 分——把书中原则写成具体规则远比只说参考这本书有效。它解决了三个痛点书籍知识 → 可执行规则每本书的决策规则、触发条件、反模式都被压缩成清单式指令按需加载规则分mini/nano/full三档不会撑爆上下文跨工具通用同一套规则可用于 Codex、Cursor、Claude Code纯 Markdown 格式一分钟上手clone 仓库与版本选择克隆仓库git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books每个书籍目录包含三个版本选择逻辑很简单版本适用场景典型用途mini默认推荐多数真实任务技能包正文、常驻项目规则nano上下文预算极紧跨工具便携基线、极小 Always 规则full深度参考、审计技能包的 reference 文件、专项会话以 Clean Code 为例三个文件分别是 clean-code.md、clean-code.mini.md 和 clean-code.nano.md。官方使用手册 docs/USAGE.md 的核心建议只有一句用能改变 AI 决策的最小机制默认选mini。第一层配置AGENTS.md 常驻规则AGENTS.md 是 Codex 原生识别的项目级指令文件作用是让 AI 在每个任务中保持稳定的工程风格偏好。推荐做法在仓库根目录创建AGENTS.md只放入一本mini规则集选择最能代表你团队偏好的书例如日常编码与代码审查选 clean-code.mini.md架构治理选 clean-architecture.mini.md若工具常驻预算非常紧张降级为nano版本仅在个别子目录需要不同约束时才在子目录放嵌套AGENTS.md或AGENTS.override.md覆盖避坑提醒来自 docs/USAGE.md 的 Codex 章节❌ 不要把多个full文件全局加载上下文会被淹❌ 不要把长流程、清单写进AGENTS.md它只适合放稳定的偏好基线✅ 根级规则保持单一来源多编辑器团队用同一份AGENTS.md作为跨工具基线第二层配置.agents/skills 按需技能常驻规则管风格技能管流程。当某本书的规则只在特定工作流中生效时重构、遗留代码改造、可靠性加固、领域建模应该做成.agents/skills/下的技能包AI 只在任务匹配时加载不占用日常上下文。推荐目录结构project/ AGENTS.md .agents/ skills/ refactoring-pass/ SKILL.md # 由 refactoring.mini.md 派生 reference.md # 可选链接或引用 refactoring.md好技能包的候选官方推荐清单refactoring.mini.md→ 重构专项working-effectively-with-legacy-code.mini.md→ 高风险遗留代码改动domain-driven-design.mini.md→ 建模密集型任务release-it.mini.md→ 生产环境可靠性变更designing-data-intensive-applications.mini.md→ 数据一致性与事件流技能包正文保持精简长示例、完整规则、可追溯性材料放到reference.md或检索系统中而不是塞进常驻指令。双层配置怎么选决策速查表你的需求推荐机制推荐版本任务需要特定书籍偏置技能或按需规则mini稳定的全仓工程偏好根级AGENTS.mdmini太紧用nano极小的常驻基线根级AGENTS.mdnano某个子目录需要不同约束嵌套AGENTS.override.mdmini或nano多步流程审查、迁移、发布技能包full作可选参考minifull大型参考资料、频繁变更的文档MCP 或检索RAGfull完整的决策指南见 docs/USAGE.md 末尾的 Decision Guide 章节。多书组合先看兼容性矩阵想同时加载多本书的规则时别拍脑袋。仓库内置了 docs/COMPATIBILITY.md 兼容性矩阵对比了全部 14 套mini规则的共存关系✅互补78 对可并行加载互不裁决❌冲突2 对例如 DDD 与 PoEAA 不要作为同级规则同时加载重叠11 对例如 Refactoring 与 Refactoring.Guru二选一即可经验法则常驻规则只保留一本主力书其余全部放进技能按需调用。矩阵中每对组合都有独立分析文档如 refactoring/refactoring-guru 组合分析。规则是怎么炼成的项目内部有一套完整的压缩工艺规则压缩流程每条规则先按决策改变型 / 微决策 / 冲突裁决 / 触发器等类别分级只有能真正改变 AI 设计、架构、重构决策的规则才进入mininano则只保留纠正已知模型偏好的最小规则集如浅包装冒充好抽象框架先行设计不安全重试等高频陷阱。每条保留/删除的规则都在traceability.md中可追溯。这也是为什么规则文件都以# OBEY {书名} by {作者}开头——它们不是读书笔记而是写给 AI 的工程行为契约。常见问题AGENTS.md 里放多少本书一本。常驻层放一个主力mini多书共存会互相稀释甚至产生冲突压力。mini 和 nano 差在哪mini保留了书中完整的决策压力和权衡处理约 40–65 行适合多数任务nano约 30–45 行只保留最危险陷阱提醒适合跨编辑器携带或预算极紧的场景。Cursor 或 Claude Code 能用吗可以。规则是纯 MarkdownClaude Code 在CLAUDE.md中加一行AGENTS.md即可复用同一基线技能放.claude/skills/Cursor 可将mini转成.cursor/rules中按路径或按需触发的.mdc规则。详见 docs/USAGE.md。总结用 Codex 玩转 agent-rules-books 的核心就三条根级AGENTS.md放一本mini规则形成稳定基线.agents/skills/放mini派生的技能包按工作流按需触发多书组合先查兼容性矩阵冲突对绝不并行加载配置完成后你可以观察 AI 在模块边界、命名、重构小步化、错误处理上的表现——这些规则的价值正是在它让 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），仅供参考