如何把书籍规则变成AI技能agent-rules-books的mini文件转SKILL.md完整实战【免费下载链接】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》《Clean Architecture》《DDD》《DDIA》等经典软件工程书籍蒸馏成了 AI 编码代理Codex、Cursor、Claude Code可以直接执行的规则集每个规则集都提供 full / mini / nano 三个版本。本实战教程就带你走一遍完整流程如何把其中的mini 规则文件改造成SKILL.md变成按需加载的 AI 技能Agent Skills让代理在重构、审查、遗留代码改造等具体任务上“开卷参考”经典书籍的决策规则而不是只挂一句“遵守某本书”的空话。为什么选 mini 文件做 AI 技能仓库为每本书发布了三个版本详见 README.md版本定位适合场景mini决策规则压缩版技能Skill首选正文nano极简常驻版上下文预算极紧的 Always-on 规则full完整参考版技能的 reference 参考文件官方使用文档 docs/USAGE.md 明确建议“mini文件通常就是正确的技能正文A mini file is usually the right skill body”理由有三决策等价mini 保留的是会真实改变代理设计、架构、重构决策的规则而不是句子级别的摘抄体积可控mini 一般在 3~7 KB适合按需注入上下文不挤占项目信息结构统一所有 mini 都遵循固定结构转成技能几乎不用改动。以 refactoring/refactoring.mini.md 为例它的结构是When to use技能激活条件什么任务该加载它Primary bias to correct代理最需要被纠正的偏差Decision rules决策规则Trigger rules触发式规则碰到风险区才激活Final checklist收尾检查清单这套结构天然就是“技能说明书”的骨架所以 mini 转 SKILL.md 是低损耗改造。第一步根据任务类型挑选书籍规则集不要一上来就做技能先确认任务匹配哪本书。docs/USAGE.md 给出了官方推荐你的任务推荐技能来源mini 文件重构代码refactoring/refactoring.mini.md高风险遗留代码改造working-effectively-with-legacy-code/working-effectively-with-legacy-code.mini.md领域建模、DDD 设计domain-driven-design/domain-driven-design.mini.md生产环境可靠性改造release-it/release-it.mini.md数据一致性、事件流、Schema 演进designing-data-intensive-applications/designing-data-intensive-applications.mini.md日常编码与代码审查clean-code/clean-code.mini.md 新手建议先从refactoring或clean-code开始它们最通用做完一个再复制流程到别的书。第二步clone 仓库拿到 mini 文件git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books仓库是 MIT 许可见 LICENSE你可以自由把 mini 文件复制到自己的项目里使用。所有文件都是纯 Markdown工具无关tool-agnostic改不改编都能用。第三步把 mini 内容写进 SKILL.md官方推荐把技能放在.agents/skills/Codex 通用或.claude/skills/Claude Code下的独立目录里。以重构技能为例目标结构如下来自 docs/USAGE.mdproject/ .agents/ skills/ refactoring-pass/ SKILL.md # 由 refactoring.mini.md 派生 reference.md # 可选链接或拷贝完整 refactoring.md转换时只需做三件事加技能元信息在 SKILL.md 顶部补上技能名称与一句话描述说明“什么任务激活它”——mini 文件开头的When to use段落如 refactoring/refactoring.mini.md可以直接改写成这段描述保留正文原样Primary bias、Decision rules、Trigger rules、Final checklist原封不动搬入不要自己加规则——这些规则是经过压缩流程提炼的随意增删会破坏书籍的“决策压力”保持精简长例子、完整规则表full 版不要塞进 SKILL.md放到reference.md或交给检索机制。⚠️ 常见误区把整本 full 文件贴进 SKILL.md。官方在 docs/USAGE.md 的“避免”清单里第一条就是不要全局加载多个 full 文件——技能要短小参考要外置。第四步按编辑器放置技能同一个 SKILL.md 在三大工具里的落点略有不同编辑器技能目录常驻规则可选Codex.agents/skills/或~/.agents/skills/根目录 AGENTS.mdClaude Code.claude/skills/name/SKILL.mdCLAUDE.md 或.claude/rules/Cursor用.cursor/rules/*.mdc的Agent Requested/Manual规则承载.cursor/rules/Codex 用户可以直接参考 docs/USAGE.md 的推荐结构project/ AGENTS.md .agents/ skills/ refactoring-pass/ SKILL.mdClaude Code 用户可以把 mini 文件直接放到.claude/skills/refactoring-pass/SKILL.md对于部署、发布这类有副作用的工作流记得按 docs/USAGE.md 的建议加上disable-model-invocation: true只允许手动触发。Cursor 用户如果不想维护技能目录可以把 mini 内容做成.cursor/rules/refactor.mdc的Manual规则用Cursor Rules显式调用效果等价。第五步验证技能真的改变了代理行为技能做完不等于生效。建议用仓库 README 里记录的验证方法自检见 README.md 的 “Does it work?” 一节让代理先输出一个任务计划如重构计划 PLAN再执行对比“带技能”和“只提书名”两种分支的产出差异重点看架构判断力模块边界、信息隐藏、职责拆分而不是单纯的静态检查分数。仓库的实测结论只写一句“OBEY A Philosophy of Software Design”得分约 46/100而加载具体 mini 规则的技能分支得分约 74/100——列出具体决策规则远比提书名有效。这正是 mini 转技能的价值所在。进阶用 workbench 文件追溯规则来源如果你不确定某条 mini 规则从哪来、压缩时丢了什么可以查看_rule-workbench/下的工程文件PROCESS.md压缩流程解释哪些规则必须保留book-thesis、decision-changing、trigger 等_rule-workbench/refactoring/traceability.md每条M*/N*规则对应的 full 原文行号RELEASE.mdmini/nano 如何从 workbench 发布到书籍目录这套溯源机制意味着你写技能时不是“凭感觉抄书”而是每条规则都能追溯到原著章节——出问题时可以精确定位是哪条规则起了作用。常见坑位清单❌ 多个 full 文件全局常驻 → ✅ 一个 mini 常驻 其余做技能按需加载docs/USAGE.md❌ SKILL.md 里塞长例子和完整目录 → ✅ 参考材料外置到 reference.md❌ 自己动手“优化”mini 规则 → ✅ 原样保留书籍偏置被稀释后技能就变“通用风格指南”了❌ 只给 Cursor/Claude 做技能Codex 没有 → ✅ 同一份 mini 可多端复用保持单一事实源总结mini 转 SKILL.md 五步法选书按任务类型选 mini 文件重构选 Refactoring遗留代码选 Legacy Code取文件clone 仓库复制对应*.mini.md改技能顶部加激活条件描述正文原样保留放目录Codex 放.agents/skills/Claude Code 放.claude/skills/Cursor 做.mdc规则验证对比计划与产出确认技能改变了代理的架构判断配合 docs/COMPATIBILITY.md 里各书之间的兼容性矩阵你还能把“Clean Code 常驻 Refactoring 技能 DDD 技能”组合成一套完整的书籍规则技能体系——这就是 agent-rules-books 从书籍到 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），仅供参考
如何把书籍规则变成AI技能？agent-rules-books的mini文件转SKILL.md完整实战
如何把书籍规则变成AI技能agent-rules-books的mini文件转SKILL.md完整实战【免费下载链接】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》《Clean Architecture》《DDD》《DDIA》等经典软件工程书籍蒸馏成了 AI 编码代理Codex、Cursor、Claude Code可以直接执行的规则集每个规则集都提供 full / mini / nano 三个版本。本实战教程就带你走一遍完整流程如何把其中的mini 规则文件改造成SKILL.md变成按需加载的 AI 技能Agent Skills让代理在重构、审查、遗留代码改造等具体任务上“开卷参考”经典书籍的决策规则而不是只挂一句“遵守某本书”的空话。为什么选 mini 文件做 AI 技能仓库为每本书发布了三个版本详见 README.md版本定位适合场景mini决策规则压缩版技能Skill首选正文nano极简常驻版上下文预算极紧的 Always-on 规则full完整参考版技能的 reference 参考文件官方使用文档 docs/USAGE.md 明确建议“mini文件通常就是正确的技能正文A mini file is usually the right skill body”理由有三决策等价mini 保留的是会真实改变代理设计、架构、重构决策的规则而不是句子级别的摘抄体积可控mini 一般在 3~7 KB适合按需注入上下文不挤占项目信息结构统一所有 mini 都遵循固定结构转成技能几乎不用改动。以 refactoring/refactoring.mini.md 为例它的结构是When to use技能激活条件什么任务该加载它Primary bias to correct代理最需要被纠正的偏差Decision rules决策规则Trigger rules触发式规则碰到风险区才激活Final checklist收尾检查清单这套结构天然就是“技能说明书”的骨架所以 mini 转 SKILL.md 是低损耗改造。第一步根据任务类型挑选书籍规则集不要一上来就做技能先确认任务匹配哪本书。docs/USAGE.md 给出了官方推荐你的任务推荐技能来源mini 文件重构代码refactoring/refactoring.mini.md高风险遗留代码改造working-effectively-with-legacy-code/working-effectively-with-legacy-code.mini.md领域建模、DDD 设计domain-driven-design/domain-driven-design.mini.md生产环境可靠性改造release-it/release-it.mini.md数据一致性、事件流、Schema 演进designing-data-intensive-applications/designing-data-intensive-applications.mini.md日常编码与代码审查clean-code/clean-code.mini.md 新手建议先从refactoring或clean-code开始它们最通用做完一个再复制流程到别的书。第二步clone 仓库拿到 mini 文件git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books仓库是 MIT 许可见 LICENSE你可以自由把 mini 文件复制到自己的项目里使用。所有文件都是纯 Markdown工具无关tool-agnostic改不改编都能用。第三步把 mini 内容写进 SKILL.md官方推荐把技能放在.agents/skills/Codex 通用或.claude/skills/Claude Code下的独立目录里。以重构技能为例目标结构如下来自 docs/USAGE.mdproject/ .agents/ skills/ refactoring-pass/ SKILL.md # 由 refactoring.mini.md 派生 reference.md # 可选链接或拷贝完整 refactoring.md转换时只需做三件事加技能元信息在 SKILL.md 顶部补上技能名称与一句话描述说明“什么任务激活它”——mini 文件开头的When to use段落如 refactoring/refactoring.mini.md可以直接改写成这段描述保留正文原样Primary bias、Decision rules、Trigger rules、Final checklist原封不动搬入不要自己加规则——这些规则是经过压缩流程提炼的随意增删会破坏书籍的“决策压力”保持精简长例子、完整规则表full 版不要塞进 SKILL.md放到reference.md或交给检索机制。⚠️ 常见误区把整本 full 文件贴进 SKILL.md。官方在 docs/USAGE.md 的“避免”清单里第一条就是不要全局加载多个 full 文件——技能要短小参考要外置。第四步按编辑器放置技能同一个 SKILL.md 在三大工具里的落点略有不同编辑器技能目录常驻规则可选Codex.agents/skills/或~/.agents/skills/根目录 AGENTS.mdClaude Code.claude/skills/name/SKILL.mdCLAUDE.md 或.claude/rules/Cursor用.cursor/rules/*.mdc的Agent Requested/Manual规则承载.cursor/rules/Codex 用户可以直接参考 docs/USAGE.md 的推荐结构project/ AGENTS.md .agents/ skills/ refactoring-pass/ SKILL.mdClaude Code 用户可以把 mini 文件直接放到.claude/skills/refactoring-pass/SKILL.md对于部署、发布这类有副作用的工作流记得按 docs/USAGE.md 的建议加上disable-model-invocation: true只允许手动触发。Cursor 用户如果不想维护技能目录可以把 mini 内容做成.cursor/rules/refactor.mdc的Manual规则用Cursor Rules显式调用效果等价。第五步验证技能真的改变了代理行为技能做完不等于生效。建议用仓库 README 里记录的验证方法自检见 README.md 的 “Does it work?” 一节让代理先输出一个任务计划如重构计划 PLAN再执行对比“带技能”和“只提书名”两种分支的产出差异重点看架构判断力模块边界、信息隐藏、职责拆分而不是单纯的静态检查分数。仓库的实测结论只写一句“OBEY A Philosophy of Software Design”得分约 46/100而加载具体 mini 规则的技能分支得分约 74/100——列出具体决策规则远比提书名有效。这正是 mini 转技能的价值所在。进阶用 workbench 文件追溯规则来源如果你不确定某条 mini 规则从哪来、压缩时丢了什么可以查看_rule-workbench/下的工程文件PROCESS.md压缩流程解释哪些规则必须保留book-thesis、decision-changing、trigger 等_rule-workbench/refactoring/traceability.md每条M*/N*规则对应的 full 原文行号RELEASE.mdmini/nano 如何从 workbench 发布到书籍目录这套溯源机制意味着你写技能时不是“凭感觉抄书”而是每条规则都能追溯到原著章节——出问题时可以精确定位是哪条规则起了作用。常见坑位清单❌ 多个 full 文件全局常驻 → ✅ 一个 mini 常驻 其余做技能按需加载docs/USAGE.md❌ SKILL.md 里塞长例子和完整目录 → ✅ 参考材料外置到 reference.md❌ 自己动手“优化”mini 规则 → ✅ 原样保留书籍偏置被稀释后技能就变“通用风格指南”了❌ 只给 Cursor/Claude 做技能Codex 没有 → ✅ 同一份 mini 可多端复用保持单一事实源总结mini 转 SKILL.md 五步法选书按任务类型选 mini 文件重构选 Refactoring遗留代码选 Legacy Code取文件clone 仓库复制对应*.mini.md改技能顶部加激活条件描述正文原样保留放目录Codex 放.agents/skills/Claude Code 放.claude/skills/Cursor 做.mdc规则验证对比计划与产出确认技能改变了代理的架构判断配合 docs/COMPATIBILITY.md 里各书之间的兼容性矩阵你还能把“Clean Code 常驻 Refactoring 技能 DDD 技能”组合成一套完整的书籍规则技能体系——这就是 agent-rules-books 从书籍到 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），仅供参考
