如何在Claude Code中配置agent-rules-booksCLAUDE.md导入、.claude/skills与Scoped Rules四步完整教程【免费下载链接】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 编码代理的即用型规则集把《Clean Code》《Refactoring》《Clean Architecture》《DDD》等经典编程书蒸馏成可直接投喂给 Claude Code、Codex、Cursor 的工程规则。本文带你用四步完成 Claude Code 配置CLAUDE.md 导入、.claude/skills技能、.claude/rules作用域规则让 AI 写代码有章可循。为什么 Claude Code 需要这套 AI 编码规则Claude Code 默认靠自由发挥写代码命名随意、重构时容易顺手改行为、碰到遗留代码就敢大刀阔斧。而 agent-rules-books 把 14 本经典软件工程著作提炼成决策规则 触发规则 收尾检查清单的结构化指令覆盖重构、架构、DDD、遗留代码、数据密集型系统等场景。每个规则集都提供三种版本选型是配置的第一步版本定位典型用途mini⭐ 推荐日常任务的最佳默认技能skill正文、常驻项目规则nano极小上下文预算的兜底常驻根文件必须极短、跨工具移植full完整权威参考版技能参考文件、审计、深度会话 核心原则用最小的机制产生最大的决策改变。一个项目只需要一本主规则书常驻其余按需加载。第一步获取规则集并选对版本仓库是 MIT 许可的纯 Markdown 规则文件直接 clone 到你的工作区即可git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books以重构工作流为例你会用到这两个文件refactoring/refactoring.mini.md —— 约 40 行含 15 条决策规则是技能正文的理想体量refactoring/refactoring.md —— 完整参考版供技能内按需引用其余 13 本如 clean-code/clean-code.nano.md结构完全相同按需替换即可。第二步通过 CLAUDE.md 导入共享规则基线官方推荐的做法是短根记忆文件 共享基线导入让 Claude Code 与 Codex、Cursor 共用同一份规则把选定的mini规则集例如refactoring.mini.md的内容保存为项目根目录的AGENTS.md在项目根CLAUDE.md中用语法导入它AGENTS.md ## Claude Code - Use skills for long procedures and checklists. - Use scoped rules for subsystem-specific guidance.这样 Claude Code 每次会话都会加载这份跨工具基线而根CLAUDE.md本身保持极短。上下文预算非常紧张时换成nano版本导入私有本地补充可放在CLAUDE.local.md不要混进共享基线。第三步把书籍工作流做成 .claude/skills 技能按书办事的最佳载体是技能skill只在执行特定类型任务时才激活不污染日常上下文。官方推荐结构project/ .claude/ skills/ refactoring-pass/ SKILL.md # 源自 refactoring.mini.md reference.md # 可选引用或拷贝 refactoring.md 完整版操作很简单新建.claude/skills/refactoring-pass/目录将 refactoring.mini.md 的内容作为SKILL.md正文mini就是为技能体量身定做的长示例、完整规则放reference.md不要塞进常驻指令。推荐做成技能的书籍组合摘自官方使用文档 docs/USAGE.mdrefactoring.mini.md→ 重构巡检working-effectively-with-legacy-code.mini.md→ 高风险遗留代码修改release-it.mini.md→ 生产可靠性改造domain-driven-design.mini.md→ 建模密集型工作第四步用 .claude/rules 为子系统配置 Scoped Rules当某条规则只对某个子目录或子系统生效时用.claude/rules/做路径作用域规则避免全局一刀切project/ AGENTS.md CLAUDE.md .claude/ rules/ # 子系统专属规则 skills/ # 书籍专属工作流典型用法给payments/**挂一份release-it.mini.md派生的可靠性规则超时、重试、熔断给数据层挂一份designing-data-intensive-applications.mini.md派生的一致性/事件流规则小体量路径提醒用nano常规场景优先mini。⚠️ 组合多本书之前先查兼容性矩阵 docs/COMPATIBILITY.md✅ 互补、 重叠二选一、❌ 冲突不可同时加载例如 DDD 与 PoEAA 即为冲突对。每份对比分析都在 docs/compatibility/ 下可放心组合。配置后验证与常见误区快速自检让 Claude Code 执行一次小重构观察它是否主动提保持行为不变、小步可回滚Refactoring 规则生效的标志触发技能让它按 refactoring-pass 技能处理这段代码确认SKILL.md被加载。官方明确列出的三个避免项新手最容易踩误区正确做法把full长文件整段贴进根 CLAUDE.md根文件保持短小长内容进技能同时导入多份互相冲突的规则查兼容性矩阵一个主基线 按需加载依赖自动记忆auto memory存规则用评审过的显式项目指令推荐文件清单使用指南本文所有配置细节出处docs/USAGE.md书籍兼容性矩阵docs/COMPATIBILITY.md技能正文示例minirefactoring/refactoring.mini.md紧凑基线示例nanoclean-code/clean-code.nano.md完整规则参考fullrefactoring/refactoring.md规则集总览与实测数据README.md四步走完后你的 Claude Code 就拥有了一本会翻书的规则手册基线常驻、技能按需、作用域精准。下次重构或改造遗留代码时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），仅供参考