10分鐘快速上手將agent-rules-books接入Claude Code、Cursor與Codex的完整教程【免費(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-booksagent-rules-books是一個(gè)為 AI 編碼智能體提供現(xiàn)成規(guī)則與技能Skills的開源項(xiàng)目覆蓋Codex、Cursor 和 Claude Code三大主流工具。它把《Clean Code》《Refactoring》《Clean Architecture》《DDD》《DDIA》等 14 本經(jīng)典軟件工程著作提煉成可直接使用的 AGENTS.md 規(guī)則集。本文是一份面向新手的完整教程帶你 10 分鐘內(nèi)完成接入。agent-rules-books 是什么為什么需要它讓 AI 寫代碼不難難的是讓 AI 寫得像你團(tuán)隊(duì)希望的那樣。你當(dāng)然可以在提示詞里寫一句請(qǐng)遵守《重構(gòu)》原則但 AI 對(duì)書名的理解往往是浮于表面的。agent-rules-books 的思路是把每本書中的決策規(guī)則、觸發(fā)條件和檢查清單顯式寫成 Markdown 規(guī)則文件讓 AI 在生成、重構(gòu)、評(píng)審代碼時(shí)真正照著做。它有三個(gè)特點(diǎn)對(duì)新手特別友好開箱即用14 個(gè)規(guī)則集全部是純 Markdown 文件復(fù)制即用無(wú)需安裝任何依賴按工具適配官方提供了 Codex、Claude Code、Cursor 各自的接入指南docs/USAGE.md有據(jù)可查每本書的目錄下都附帶traceability.md說(shuō)明每條規(guī)則出自原著哪部分30秒看懂mini、nano、full 三個(gè)版本怎么選每個(gè)規(guī)則集都有三個(gè)版本這是新手最容易困惑的地方記住下面的表格即可版本定位什么時(shí)候用mini推薦起步日常任務(wù)的主力版本默認(rèn)選擇作為技能Skill或項(xiàng)目級(jí)基線nano極簡(jiǎn)版約 2KB上下文預(yù)算非常緊張或需要跨工具共享的超小基線full完整參考版深度審計(jì)、一次性高強(qiáng)度會(huì)話、作為技能的參考文件官方給出的核心原則是從最小的、能改變 AI 決策的機(jī)制開始。多數(shù)場(chǎng)景下一個(gè)mini就足夠了。以《Clean Code》為例三個(gè)版本分別是clean-code.mini.md約 40 行含決策規(guī)則 觸發(fā)規(guī)則 檢查清單clean-code.nano.md約 30 行clean-code.md完整參考版接入步驟一獲取規(guī)則文件兩種方式任選其一。方式 A直接瀏覽并復(fù)制你需要的規(guī)則文件推薦新手倉(cāng)庫(kù)按書名組織目錄例如《重構(gòu)》在 refactoring/ 目錄《實(shí)用程序員》在 the-pragmatic-programmer/ 目錄。找到合適版本的.md文件復(fù)制內(nèi)容到你項(xiàng)目里即可。方式 B克隆倉(cāng)庫(kù)git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books.git建議只復(fù)制需要的規(guī)則文件到你的項(xiàng)目不要把整個(gè)倉(cāng)庫(kù)當(dāng)作項(xiàng)目的一部分——它只是規(guī)則素材庫(kù)。接入步驟二Codex 最快配置方法Codex 原生讀取AGENTS.md接入最簡(jiǎn)單兩步走項(xiàng)目級(jí)基線把選好的mini規(guī)則內(nèi)容放進(jìn)項(xiàng)目根目錄的AGENTS.md或子目錄按需放置技能Skill把書專屬的工作流做成技能放入.agents/skills/推薦的項(xiàng)目結(jié)構(gòu)project/ AGENTS.md # 一個(gè) mini 規(guī)則集作為全局基線 .agents/ skills/ refactoring-pass/ SKILL.md # 來(lái)自 refactoring.mini.md官方推薦的 refactoring.mini.md 就是很好的技能起點(diǎn)它明確要求 AI小步走、保持行為不變、先建安全網(wǎng)再動(dòng)刀——這正是新手最怕 AI 一上來(lái)就大改代碼的問(wèn)題。?? 避免把多個(gè)full文件全局加載那會(huì)擠占寶貴的上下文。接入步驟三Claude Code 一鍵導(dǎo)入 AGENTS.mdClaude Code 的記憶入口是CLAUDE.md官方推薦短根記憶 按需擴(kuò)展的模式保持根目錄CLAUDE.md盡量短用一行AGENTS.md導(dǎo)入共享基線實(shí)現(xiàn)跨工具一份規(guī)則、多處復(fù)用project/ AGENTS.md # 共享的 mini 規(guī)則基線 CLAUDE.md # 內(nèi)容AGENTS.md 少量 Claude 專屬說(shuō)明 .claude/ rules/ # 子系統(tǒng)級(jí)規(guī)則 skills/ review-pass/ SKILL.md # 來(lái)自某個(gè) mini 規(guī)則集書專屬流程做成技能例如把 release-it.mini.md 放進(jìn).claude/skills/只在處理生產(chǎn)可靠性問(wèn)題時(shí)才被加載這個(gè)模式的好處Claude Code 和 Codex 共用同一份AGENTS.md基線規(guī)則只需維護(hù)一次。接入步驟四Cursor 規(guī)則文件配置技巧Cursor 最強(qiáng)的原生機(jī)制是.cursor/rules/*.mdc項(xiàng)目規(guī)則推薦一個(gè)短基線 多個(gè)主題規(guī)則的拆分project/ .cursor/ rules/ base.mdc # 唯一的 Always 規(guī)則來(lái)自某個(gè) mini必須保持短小 payments.mdc # Auto Attached僅對(duì) payments/** 目錄生效 refactor.mdc # Manual重構(gòu)時(shí)手動(dòng) Cursor Rules 調(diào)用 ddd.mdc # Agent Requested領(lǐng)域建模任務(wù)時(shí)按需加載新手常見(jiàn)誤區(qū)是把所有規(guī)則塞進(jìn)一個(gè)巨型Always規(guī)則里。正確做法是最多一個(gè)項(xiàng)目級(jí) Always 規(guī)則用 mini 或 nano其余按目錄或任務(wù)類型拆分用Cursor Rules顯式調(diào)用。簡(jiǎn)單項(xiàng)目也可以直接用根目錄AGENTS.md兜底。多本書怎么選先看兼容性矩陣想同時(shí)加載多本書時(shí)先查官方的兼容性矩陣docs/COMPATIBILITY.md它用三種標(biāo)記告訴你兩本書能否同時(shí)作為活躍規(guī)則? 互補(bǔ)可以放心組合 重疊二選一即可如《重構(gòu)》與《Refactoring.Guru》? 沖突不要同時(shí)加載如 DDD 與《企業(yè)應(yīng)用架構(gòu)模式》決策口訣來(lái)自 docs/USAGE.md你的需求推薦做法某個(gè)任務(wù)需要特定書的視角從對(duì)應(yīng)mini創(chuàng)建技能按需調(diào)用想要穩(wěn)定的全倉(cāng)庫(kù)工程基調(diào)只用一個(gè)mini作為項(xiàng)目基線上下文預(yù)算極緊用nano需要大篇幅參考資料交給檢索 / MCP不要塞進(jìn)常駐提示詞常見(jiàn)問(wèn)題 FAQQ1這些規(guī)則是書的官方內(nèi)容嗎不是。它們是受原著啟發(fā)的工程指令用于約束 AI 行為不是書籍摘要也不能替代讀原書詳見(jiàn) README 中的說(shuō)明。Q2mini 和 nano 差距多大nano 約 2KB只保留最核心的傾向性提醒mini 通常 4~8KB包含完整的決策規(guī)則、觸發(fā)規(guī)則與檢查清單能真正改變 AI 的實(shí)現(xiàn)選擇。日常用 mini 即可。Q3規(guī)則文件會(huì)隨工具更新嗎每個(gè)規(guī)則集都附帶traceability.md如 refactoring/traceability.md記錄規(guī)則與書籍結(jié)構(gòu)的對(duì)應(yīng)關(guān)系版本歷史見(jiàn) CHANGELOG.md?？偨Y(jié)agent-rules-books 的接入門檻極低選一個(gè)mini規(guī)則集 → 放進(jìn)對(duì)應(yīng)工具的規(guī)則入口 → 書專屬流程做成技能。Codex 用AGENTS.md最省事Claude Code 用AGENTS.md導(dǎo)入實(shí)現(xiàn)跨工具復(fù)用Cursor 用.cursor/rules做精細(xì)作用域控制。先從一本書、一個(gè) mini 起步等 AI 的代碼風(fēng)格穩(wěn)定后再按兼容性矩陣逐步疊加更多規(guī)則集?！久赓M(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-books創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 10分鐘快速上手：將agent-rules-books接入Claude Code、Cursor與Codex的完整教程
10分鐘快速上手將agent-rules-books接入Claude Code、Cursor與Codex的完整教程【免費(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-booksagent-rules-books是一個(gè)為 AI 編碼智能體提供現(xiàn)成規(guī)則與技能Skills的開源項(xiàng)目覆蓋Codex、Cursor 和 Claude Code三大主流工具。它把《Clean Code》《Refactoring》《Clean Architecture》《DDD》《DDIA》等 14 本經(jīng)典軟件工程著作提煉成可直接使用的 AGENTS.md 規(guī)則集。本文是一份面向新手的完整教程帶你 10 分鐘內(nèi)完成接入。agent-rules-books 是什么為什么需要它讓 AI 寫代碼不難難的是讓 AI 寫得像你團(tuán)隊(duì)希望的那樣。你當(dāng)然可以在提示詞里寫一句請(qǐng)遵守《重構(gòu)》原則但 AI 對(duì)書名的理解往往是浮于表面的。agent-rules-books 的思路是把每本書中的決策規(guī)則、觸發(fā)條件和檢查清單顯式寫成 Markdown 規(guī)則文件讓 AI 在生成、重構(gòu)、評(píng)審代碼時(shí)真正照著做。它有三個(gè)特點(diǎn)對(duì)新手特別友好開箱即用14 個(gè)規(guī)則集全部是純 Markdown 文件復(fù)制即用無(wú)需安裝任何依賴按工具適配官方提供了 Codex、Claude Code、Cursor 各自的接入指南docs/USAGE.md有據(jù)可查每本書的目錄下都附帶traceability.md說(shuō)明每條規(guī)則出自原著哪部分30秒看懂mini、nano、full 三個(gè)版本怎么選每個(gè)規(guī)則集都有三個(gè)版本這是新手最容易困惑的地方記住下面的表格即可版本定位什么時(shí)候用mini推薦起步日常任務(wù)的主力版本默認(rèn)選擇作為技能Skill或項(xiàng)目級(jí)基線nano極簡(jiǎn)版約 2KB上下文預(yù)算非常緊張或需要跨工具共享的超小基線full完整參考版深度審計(jì)、一次性高強(qiáng)度會(huì)話、作為技能的參考文件官方給出的核心原則是從最小的、能改變 AI 決策的機(jī)制開始。多數(shù)場(chǎng)景下一個(gè)mini就足夠了。以《Clean Code》為例三個(gè)版本分別是clean-code.mini.md約 40 行含決策規(guī)則 觸發(fā)規(guī)則 檢查清單clean-code.nano.md約 30 行clean-code.md完整參考版接入步驟一獲取規(guī)則文件兩種方式任選其一。方式 A直接瀏覽并復(fù)制你需要的規(guī)則文件推薦新手倉(cāng)庫(kù)按書名組織目錄例如《重構(gòu)》在 refactoring/ 目錄《實(shí)用程序員》在 the-pragmatic-programmer/ 目錄。找到合適版本的.md文件復(fù)制內(nèi)容到你項(xiàng)目里即可。方式 B克隆倉(cāng)庫(kù)git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books.git建議只復(fù)制需要的規(guī)則文件到你的項(xiàng)目不要把整個(gè)倉(cāng)庫(kù)當(dāng)作項(xiàng)目的一部分——它只是規(guī)則素材庫(kù)。接入步驟二Codex 最快配置方法Codex 原生讀取AGENTS.md接入最簡(jiǎn)單兩步走項(xiàng)目級(jí)基線把選好的mini規(guī)則內(nèi)容放進(jìn)項(xiàng)目根目錄的AGENTS.md或子目錄按需放置技能Skill把書專屬的工作流做成技能放入.agents/skills/推薦的項(xiàng)目結(jié)構(gòu)project/ AGENTS.md # 一個(gè) mini 規(guī)則集作為全局基線 .agents/ skills/ refactoring-pass/ SKILL.md # 來(lái)自 refactoring.mini.md官方推薦的 refactoring.mini.md 就是很好的技能起點(diǎn)它明確要求 AI小步走、保持行為不變、先建安全網(wǎng)再動(dòng)刀——這正是新手最怕 AI 一上來(lái)就大改代碼的問(wèn)題。?? 避免把多個(gè)full文件全局加載那會(huì)擠占寶貴的上下文。接入步驟三Claude Code 一鍵導(dǎo)入 AGENTS.mdClaude Code 的記憶入口是CLAUDE.md官方推薦短根記憶 按需擴(kuò)展的模式保持根目錄CLAUDE.md盡量短用一行AGENTS.md導(dǎo)入共享基線實(shí)現(xiàn)跨工具一份規(guī)則、多處復(fù)用project/ AGENTS.md # 共享的 mini 規(guī)則基線 CLAUDE.md # 內(nèi)容AGENTS.md 少量 Claude 專屬說(shuō)明 .claude/ rules/ # 子系統(tǒng)級(jí)規(guī)則 skills/ review-pass/ SKILL.md # 來(lái)自某個(gè) mini 規(guī)則集書專屬流程做成技能例如把 release-it.mini.md 放進(jìn).claude/skills/只在處理生產(chǎn)可靠性問(wèn)題時(shí)才被加載這個(gè)模式的好處Claude Code 和 Codex 共用同一份AGENTS.md基線規(guī)則只需維護(hù)一次。接入步驟四Cursor 規(guī)則文件配置技巧Cursor 最強(qiáng)的原生機(jī)制是.cursor/rules/*.mdc項(xiàng)目規(guī)則推薦一個(gè)短基線 多個(gè)主題規(guī)則的拆分project/ .cursor/ rules/ base.mdc # 唯一的 Always 規(guī)則來(lái)自某個(gè) mini必須保持短小 payments.mdc # Auto Attached僅對(duì) payments/** 目錄生效 refactor.mdc # Manual重構(gòu)時(shí)手動(dòng) Cursor Rules 調(diào)用 ddd.mdc # Agent Requested領(lǐng)域建模任務(wù)時(shí)按需加載新手常見(jiàn)誤區(qū)是把所有規(guī)則塞進(jìn)一個(gè)巨型Always規(guī)則里。正確做法是最多一個(gè)項(xiàng)目級(jí) Always 規(guī)則用 mini 或 nano其余按目錄或任務(wù)類型拆分用Cursor Rules顯式調(diào)用。簡(jiǎn)單項(xiàng)目也可以直接用根目錄AGENTS.md兜底。多本書怎么選先看兼容性矩陣想同時(shí)加載多本書時(shí)先查官方的兼容性矩陣docs/COMPATIBILITY.md它用三種標(biāo)記告訴你兩本書能否同時(shí)作為活躍規(guī)則? 互補(bǔ)可以放心組合 重疊二選一即可如《重構(gòu)》與《Refactoring.Guru》? 沖突不要同時(shí)加載如 DDD 與《企業(yè)應(yīng)用架構(gòu)模式》決策口訣來(lái)自 docs/USAGE.md你的需求推薦做法某個(gè)任務(wù)需要特定書的視角從對(duì)應(yīng)mini創(chuàng)建技能按需調(diào)用想要穩(wěn)定的全倉(cāng)庫(kù)工程基調(diào)只用一個(gè)mini作為項(xiàng)目基線上下文預(yù)算極緊用nano需要大篇幅參考資料交給檢索 / MCP不要塞進(jìn)常駐提示詞常見(jiàn)問(wèn)題 FAQQ1這些規(guī)則是書的官方內(nèi)容嗎不是。它們是受原著啟發(fā)的工程指令用于約束 AI 行為不是書籍摘要也不能替代讀原書詳見(jiàn) README 中的說(shuō)明。Q2mini 和 nano 差距多大nano 約 2KB只保留最核心的傾向性提醒mini 通常 4~8KB包含完整的決策規(guī)則、觸發(fā)規(guī)則與檢查清單能真正改變 AI 的實(shí)現(xiàn)選擇。日常用 mini 即可。Q3規(guī)則文件會(huì)隨工具更新嗎每個(gè)規(guī)則集都附帶traceability.md如 refactoring/traceability.md記錄規(guī)則與書籍結(jié)構(gòu)的對(duì)應(yīng)關(guān)系版本歷史見(jiàn) CHANGELOG.md?？偨Y(jié)agent-rules-books 的接入門檻極低選一個(gè)mini規(guī)則集 → 放進(jìn)對(duì)應(yīng)工具的規(guī)則入口 → 書專屬流程做成技能。Codex 用AGENTS.md最省事Claude Code 用AGENTS.md導(dǎo)入實(shí)現(xiàn)跨工具復(fù)用Cursor 用.cursor/rules做精細(xì)作用域控制。先從一本書、一個(gè) mini 起步等 AI 的代碼風(fēng)格穩(wěn)定后再按兼容性矩陣逐步疊加更多規(guī)則集?！久赓M(fèi)下載鏈接】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.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-books創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考