新闻详情

新闻详情

首页 / 资讯中心 / 详情

如何把书籍规则变成AI技能?agent-rules-books的mini文件转SKILL.md完整实战

发布时间:2026/10/1 16:09:02来源:尧图网络
如何把书籍规则变成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),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

消费级AI智能体的信任设计:从可解释性到用户可控性 2026/10/1 18:17:37

消费级AI智能体的信任设计:从可解释性到用户可控性

1. 这不是又一个“AI助手”,而是消费级智能体的第一次信任压力测试 TechCrunch播客里那期关于Meta Muse的讨论,我连听三遍才敢动笔写这篇。不是因为内容晦涩,恰恰相反——它太直白、太真实,像一记闷棍打在所有AI产品从业者的太阳穴…

阅读更多 →
SpringBoot+Java农产品电商系统毕业设计实战:从数据库设计到订单闭环实现 2026/10/1 18:17:37

SpringBoot+Java农产品电商系统毕业设计实战:从数据库设计到订单闭环实现

做毕设选JavaSpringBoot做农产品在线管理系统,放在今年这个时间点,其实是个挺聪明的选择。这个题目听起来像是个“电商商城”,但真正做下来你会发现,它远比单纯写一个增删改查页面有东西可挖:前端用户要浏览、搜索、加…

阅读更多 →
Android 14自定义系统服务注册全流程:从AIDL到SELinux 2026/10/1 18:17:37

Android 14自定义系统服务注册全流程:从AIDL到SELinux

我前阵子在搞一个 Android 14 的系统定制需求,碰到一个挺典型的场景:设备厂商想让第三方 App 通过标准的 Context.getSystemService() 拿到一个自定义的系统能力,而不是靠广播、ContentProvider 或者直接开 Socket。说白了,就是…

阅读更多 →
LVM还是Btrfs?搞懂层次、快照与重装场景再选型 2026/10/1 18:17:37

LVM还是Btrfs?搞懂层次、快照与重装场景再选型

别人问我最多的一句话是:LVM 和 Btrfs 不都能管卷吗,到底选哪个?这个问题本身就带着一个常见的理解偏差——它把两个处于不同层次的东西放在了一起比较。我自己在生产环境里两个都用过:老一点的机房机器全是 LVM ext4/xfs&#x…

阅读更多 →
二手车销售数据分析可视化系统实践:从数据治理到价格模型 2026/10/1 18:17:37

二手车销售数据分析可视化系统实践:从数据治理到价格模型

半年前有个做二手车门店的朋友问我:同款同年份的车,有的挂价12万,有的挂价9万,到底哪个才是市场价?我当时下意识说"看平台成交价呗",结果他一句话把我问住了——平台上挂的全是标价,真…

阅读更多 →
std::thread 入门:启动、join、detach 与生命周期 2026/10/1 18:17:23

std::thread 入门:启动、join、detach 与生命周期

std::thread 是 C11 给并发编程开的第一道门,也是最容易在第一个小时就撞墙的一道门。撞的方式还很吓人:不是编译错误,不是抛异常,而是整个进程被 std::terminate 直接干掉,运行库只留下几行 terminate called without…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉