AI-RULES：让AI项目规则geng懂你的项目

随着AI编程工具的兴起，我们在享受其带来的高效与便捷的同时也面临着新的挑战。这些工具虽然Neng够生成代码、修复bug、生成测试，但往往会犯一些团队里反复强调过的错误。如何让AI在生成代码时就知道我们的架构边界、目录结构、安全规则和修复约束？这正是AI-RULES要解决的问题。

AI-RULES是一个CLI工具，它为AI编程工具提供了一套项目本地的规则协议。通过这套协议，AI在写代码、审计代码、修复代码之前，Ke以先理解团队的约束。它不是让AI“凭感觉读README”，而是给AI一套明确的规则输入。

例如在Spring项目中，AI可Neng会直接在Controller中访问Repository；在前端项目中，它可Neng直接在页面组件中fetch数据；在FastAPI项目中，它可Neng在route里直接操作DB session。这些问题不是AI不聪明，而是它经常缺少“项目级规则上下文”。

你需要安装AI-RULES：

npm install -g ai-law

然后进入你的项目目录：

cd your-project

初始化规则：

ai-law init

CLI会让你选择语言和模板，例如Java/Spring、Python/FastAPI等。初始化后会在你的项目里生成.ai-rules/目录，包含规则配置文件和缓存目录。

检查配置是否合理：

ai-law doctor

Ru果你的目录映射不对，它会给出显眼警告，例如：

========== AI-RULES WARNING ==========IMPORTANT: pathAliases.@controller points to 'src/main/java/**/controller',but 'src/main/java' was not found. Open .ai-rules/config.json and update this alias for your project layout.========================================

运行审计命令：

ai-law audit

或者直接查kan结构化上下文：

ai-law audit --json> ai-rule-report.json

假设AI-RULES发现Spring Controller里直接依赖Repository，生成的报告可Neng是：

{  "version": "",  "summary": {    "total": ,    "fatal": ,    "warn": ,    "info":   },  "violations": }

接着你Ke以运行：

ai-law fix --issueId ISSUE-

或者批量生成修复Prompt：

ai-law fix --all --group-by-rule

Harness这类平台hen适合Zuo代码仓库边界的治理，比如PRNeng不Neng合并、分支保护、reviewer数量、secret scanning、CODEOWNERS等。这些Neng力非常重要，它们保护的是代码进入仓库和合并前的边界。

Harnessgeng偏向治理代码仓库边界；AI-RULESgeng偏向治理AI写代码的过程。

两者不是替代关系，而是互补关系。Ru果你Yi经有Harness或其它代码治理平台，AI-RULES仍然有价值，因为它Ke以把治理提前到AI生成代码的阶段，减少后面被CI、Review、合并规则拦下来的次数。

我认为Zui核心的区别是：在代码进入PR、CI、merge gate之前，AI是否Yi经知道应该怎么写？

让AI在代码进入Review、CI、合并门禁之前，就尽量按照你的项目规则写代码。

Ru果你也在团队里使用Codex、Cursor、Claude Code或类似AI编码工具，并且经常遇到“AI写得Neng跑，但不符合项目规范”的问题，

希望通过这篇文章，你Neng对AI-RULES有geng深入的了解，并将其应用到你的项目中，让你的AI编码之旅geng加顺畅！