rulebook

为AI编码智能体提供统一规则与质量门禁的开发框架。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:rulebook。
它的用途是:为AI编码智能体提供统一规则与质量门禁的开发框架。
完整的 Skill 内容见:https://321skill.com/skills/rulebook/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“/spec 为我们的REST API添加一个带缓存的用户查询端点”,Rulebook会引导AI明确需求、创建符合规范的任务清单。然后说“/rulebook-driver”,AI会按照AGENTS.md中的规则,自动完成代码编写、运行测试并通过质量门禁,最终生成可合并的代码。

介绍

Rulebook 旨在解决AI编码智能体(如Claude Code、Cursor等)在开发时因缺乏统一规范而导致的代码质量参差不齐、风格不一致的问题。它通过一个init命令,自动分析项目技术栈(支持28种语言),生成业界通用的AGENTS.md规范文件,并配置好代码质量门禁(如预提交检查、测试)和MCP工具集。

使用时,开发者只需运行npx @hivehub/rulebook@latest init初始化项目,即可获得一套完整的规则体系。之后,在Claude Code等支持AGENTS.md的智能体中,通过/spec命令创建功能规格,智能体便会自动遵循规则进行开发,并通过/rulebook-driver命令驱动任务执行和代码审查。

它非常适合希望将AI智能体高效、规范地融入现有开发流程的团队或个人开发者,尤其是全栈开发、智能体开发者和项目经理,能显著提升AI辅助开发的可靠性和一致性。

建议在项目初期或引入新AI工具时使用Rulebook进行初始化。对于已有项目,可使用update命令平滑升级规则。其设计追求极简和低开销,但请注意,它主要服务于编码场景,对于非代码生成类的AI任务(如纯内容创作)可能不是最佳选择。

核心特点

与需要为不同AI工具单独适配规则的方案不同,Rulebook首创并生成通用的`AGENTS.md`标准文件,能被所有支持该标准的AI编码智能体原生读取,实现了“一次编写,处处生效”。同时,其v7版本将会话开销大幅降低77%,并通过仅一个路径守卫钩子和零权限提示的设计,最大化开发自主性,避免过度干预。

注意事项

主要专注于规范和提升AI辅助的代码开发流程,不适合非编码类的纯内容生成或数据分析场景。

常见问题

Rulebook 和普通的代码规范工具(如 ESLint)有什么区别?

Rulebook 生成的是给AI智能体阅读的“行为规范”(AGENTS.md),指导AI如何思考、拆解任务和编写代码;而ESLint等是代码提交后运行的“静态检查工具”。Rulebook 作用于AI创作阶段,从源头保证质量。

已经用了 Claude Code,还需要 Rulebook 吗?

需要。Claude Code 本身是执行工具,Rulebook 为它(及其他工具)提供统一、可定制、带质量门禁的“规则手册”,能显著提升其输出的一致性和项目规范性,尤其适合团队协作。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/rulebook/raw/index.md 读取 rulebook 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。