agent-rules-books

把经典编程书变成 AI 编码规则，提升代码质量

agent-rules-books 是一个为 AI 编程智能体（如 Codex、Cursor、Claude Code）提供规则和技能的开源项目。它受《Clean Code》《重构》《领域驱动设计》《整洁架构》和《数据密集型应用系统设计》等经典编程书籍启发，将这些书中的最佳实践转化为 AGENTS.md 规则和可复用的 AI 技能，帮助开发者在使用 AI 编码工具时自动遵循高质量工程标准。项目解决了 AI 生成代码质量参差不齐、缺乏架构约束的问题，核心能力包括：提供分门别类的规则文件，可注入到 AI 工作流中；提供可复用的技能模块，增强 AI 对特定场景的处理能力；支持多种主流 AI 编码工具，易于集成。通过将书籍智慧编码化，项目提升了 AI 辅助开发的代码可维护性、可读性和架构一致性。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2848

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队ciembor

所属国家

官网地址https://ciembor.github.io/agent-rules-books

GitHubhttps://github.com/ciembor/agent-rules-books

定价模式free

价格说明开源项目，MIT 许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言

技术栈/模型agent-rules,agent-skills,agent-skills-manager,agents-md,agents-rules,agents-skills,agentsmd,ai-agent,ai-skills,claude-code,claude-code-skills,code-quality,codex,codex-skills,cursor-rules,cursor-skills,domain-driven-design,programming-books,refactoring

GitHub 星标★ 2848

30天Star增速

HF 下载量

上线时间2026-04-16 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：入门约 5 分钟部署方式：命令行工具 5 步

环境要求

已安装 Node.js 及 npm（README 中唯一列出的前置条件）
可访问网络的终端环境（通过 npx 从 npm 拉取并运行 Skills CLI，无需单独安装 skills）
一个支持 AGENTS.md 规则/技能的 AI 编码工具（如 Codex、Cursor、Claude Code）

安装与启动步骤

1确认 Node.js 环境

README 要求先安装 Node.js 与 npm，Skills CLI 可直接用 npx 运行，不必全局安装 skills 包。
```
node -v && npm -v
```
2查看可用技能

仅列出仓库中可安装的技能清单，不做任何写入，可先用它确认技能名称。
```
npx skills add ciembor/agent-rules-books --list
```
3安装全部技能

一次性把仓库内所有书籍技能装到当前环境，适合想整体体验的用法。
```
npx skills add ciembor/agent-rules-books --all
```
4只装单个技能

按 --list 中的技能名安装单个技能，例如 refactoring，避免引入不需要的规则。
```
npx skills add ciembor/agent-rules-books --skill refactoring
```
5查看编辑器配置

Codex、Claude Code、Cursor 的常驻/按需、作用域规则等设置，请阅读仓库 docs/USAGE.md。

关键配置

配置项	必填	说明	示例
`--skill`	否	指定要安装的单个技能名，与 --all 二选一	`refactoring`
`规则版本 mini/nano/full`	否	每个技能默认加载 mini；nano 适合上下文紧张，full 为完整参考	`mini`
`SKILL.md`	否	每个书籍目录中的标准技能入口文件，决定技能如何被加载	`SKILL.md`

如何确认成功

执行 npx skills add ciembor/agent-rules-books --list 能打印出技能列表，即表示 CLI 可用、仓库可正常读取。

常见问题

Q：需要先单独安装 skills 这个 CLI 吗？

A：不需要。README 明确说明通过 npx 直接运行 Skills CLI 即可，无需单独安装 skills。

Q：怎么只安装某一个技能？

A：用 --skill 加上技能名，例如 npx skills add ciembor/agent-rules-books --skill refactoring；先跑 --list 可查看可选技能名。

Q：技能默认使用哪一版规则？

A：每个技能默认加载对应的 mini 规则集，这是多数实际任务推荐的版本，同时保留 full 文件作为更深入的参考材料。

Q：怎么在 Codex、Cursor、Claude Code 里配置使用？

A：README 指向 docs/USAGE.md，其中覆盖常驻与按需使用、skills、作用域规则以及各编辑器偏好的安装方式。

注意事项

README 只给出基于 npx 的 Agent Skills CLI 安装方式，未提供 pip、Docker 等其它安装命令。
仓库同时提供 mini、nano、full 三种与工具无关的 Markdown 规则版本，可按上下文预算选择。
除技能方式外，README 还提到手动安装、作用域安装、常驻安装及编辑器专属安装，细节需查看 docs/USAGE.md。
规则来源为重构、架构、DDD、代码质量等领域经典书籍，项目采用 MIT 许可证。

核心亮点

直接引用经典书籍原则，规则有理论支撑，非凭空捏造
覆盖多种主流 AI 编码工具，集成方式灵活
规则和技能模块化，可按需选用，易于扩展

不足之处

规则可能过于理想化，实际项目场景需调整
文档/社区待观察

适用场景

团队使用 AI 编码助手时统一代码风格和质量基线
个人开发者希望 AI 生成更符合整洁架构的代码
学习如何将工程最佳实践落地到 AI 工作流

替代项目

awesome-claude-code、cursor-rules、awesome-codex

项目介绍

agent-rules-books 是智能体领域的开源项目，由 ciembor 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,848）位列前 30%，在智能体分类的 2,517 个项目里位列前 14%。

近 42 天，它的 GitHub 星标从 2,477 增加到 2,848，净增 371。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。MIT 许可证，完全免费，无付费版本。从国内网络环境看，可直接访问。

它主要面向的使用场景是：团队使用AI编码助手时统一代码风格和质量基线。同类可对比的替代方案包括 awesome-claude-code、cursor-rules、awesome-codex。

上一篇：bitterbot-desktop

下一篇：fulling