---

如何让GPT在项目中更好用？核心靠AGENTS.md+RULES，附AI辅助工具清单

你是否遇到过：GPT生成的代码技术没问题，但风格与项目脱节、架构不符合约束、命名规范不一致，改代码的时间比写代码还长？

本质原因：AI每次会话都是“从零开始”，缺项目专属上下文与规则约束。而AGENTS.md与RULES就是解决这个问题的核心方案——给AI一份“项目入职手册”，让它精准对齐团队规范。下面从概念、作用、实操到辅助工具，一次性讲透。

一、AGENTS.md：AI的“项目级说明书”

1. 什么是AGENTS.md？

AGENTS.md是放在项目根目录的纯Markdown文件（文件名必须全大写），是Linux基金会主导的开放标准，被GitHub Copilot、Claude、Cursor、Windsurf等20+主流AI编程工具原生支持。

简单说：写给AI看的README——README给人看，AGENTS.md给AI看，专门解决AI“不懂项目规矩”的问题。

2. 核心作用：让AI“懂规范、守边界、提质量”

• 注入项目专属上下文：自动读取技术栈（如React18+TypeScript5）、架构模式（如DDD/微服务）、依赖版本、目录结构，避免AI用默认栈生成代码。
• 强制代码风格统一：定义命名规范（如变量小驼峰、常量全大写）、代码格式（如缩进2空格、禁用var）、注释要求（如函数必须写JSDoc），确保AI输出与团队一致。
• 划定“能做/不能做”边界：明确禁止修改的文件（如/config、/legacy）、必须使用的工具（如用pnpm而非npm）、测试命令（如pnpm test:unit），减少AI“瞎改”。
• 提升效率+降低成本：权威数据显示，使用AGENTS.md的项目，AI生成代码的纠错率下降42%，token用量减少16.6%，开发周期缩短28.6%。

3. 核心内容模板（直接复制可用）

# AGENTS.md - 项目AI协作规范
## 1. 项目基础信息
- 技术栈：React 18.2 + TypeScript 5.1 + Vite 4.4 + Tailwind CSS 3.3
- 架构模式：前端模块化（原子设计）、后端DDD领域驱动
- 包管理器：pnpm 8.15（禁止用npm/yarn）
- 节点版本：18.17+（必须严格匹配）

## 2. 代码规范（强制执行）
### 命名规则
- 变量/函数：小驼峰（如`getUserInfo`）
- 常量：全大写+下划线（如`MAX_RETRY_COUNT`）
- 组件：大驼峰（如`UserCard`）
- 接口/类型：大驼峰+I前缀（如`IUser`）

### 格式要求
- 缩进：2空格（禁止tab）
- 引号：单引号优先，JSX用双引号
- 换行：函数/组件结束必须空一行
- 禁用：any、var、隐式any、未处理的异常

## 3. 目录约束（禁止修改）
- ✅ 可操作：/src/components、/src/pages、/src/utils
- ❌ 禁止修改：/config、/legacy、/public、package.json（版本除外）

## 4. 命令与测试
- 启动：pnpm dev
- 构建：pnpm build
- 单元测试：pnpm test:unit
- 提交规范：遵循Conventional Commits（如feat: 新增用户列表）

二、RULES（.cursorrules/项目规则）：IDE级“精准约束”

1. 什么是RULES？

RULES是IDE专属的细粒度规则文件，主流为Cursor IDE的.cursorrules（或新版.cursor/rules），也包含Claude专属的CLAUDE.md、Gemini专属的GEMINI.md。

如果说AGENTS.md是项目级通用手册（所有AI工具生效），那RULES就是IDE级定制条款（对特定AI工具生效），规则更细、优先级更高。

2. 核心作用：补全AGENTS.md，实现“毫米级对齐”

• 优先级更高：同一规则冲突时，RULES覆盖AGENTS.md（适合IDE专属特殊约束）。
• 场景更细分：可按文件类型（如.tsx/.css）、目录（如/src/api）、操作类型（如生成/重构/注释）定制规则。
• 工具专属优化：比如Cursor的RULES可强制AI生成代码时自动导入依赖、匹配现有组件结构、复用工具函数。

3. 与AGENTS.md的区别（一目了然）

维度	AGENTS.md	RULES（.cursorrules）
适用范围	全AI工具（Copilot/Claude/Cursor）	特定IDE（Cursor）/工具
文件位置	项目根目录	根目录（.cursorrules）或.cursor/rules
优先级	通用默认	高于AGENTS.md（冲突时生效）
核心定位	项目级通用规范	IDE级细粒度定制
格式	纯Markdown	Markdown（支持特殊指令）

三、实操：3分钟配置，让GPT精准适配项目

步骤1：创建AGENTS.md（根目录）

复制上面模板，按项目实际修改技术栈、规范、目录约束，提交到Git（所有成员同步）。

步骤2：创建RULES（可选，Cursor用户推荐）

根目录新建.cursorrules，补充IDE专属规则，示例：

# Cursor专属规则（优先级高于AGENTS.md）
- 所有TSX组件必须使用函数式+TypeScript接口
- 生成组件时自动导入同级目录的工具函数
- 禁止生成重复组件，优先复用/src/components下现有组件
- 注释必须用中文，关键逻辑必须加// 说明

步骤3：AI工具自动识别

重启IDE（Cursor/VS Code），AI会自动读取根目录的AGENTS.md和RULES，后续生成代码时自动遵循所有规则，无需每次重复提示。

四、常用AI辅助工具（提升GPT项目效率，全覆盖）

1. AI编码增强类（核心，搭配AGENTS.md效果翻倍）

• Cursor：基于GPT-4o的IDE，原生支持AGENTS.md+RULES，代码生成/重构/调试一体化，自动对齐项目规范。
• GitHub Copilot：主流AI补全工具，实时读取AGENTS.md，代码补全准确率提升50%，适合VS Code/IDEA。
• Claude Code：Anthropic官方AI编码工具，支持CLAUDE.md+AGENTS.md，长上下文理解强，适合复杂架构设计。

2. Agent框架类（让GPT自主执行复杂任务）

• CrewAI：多智能体协作框架，可分配“架构师/开发/测试”角色，自动拆解任务、生成代码、执行测试，适合端到端项目开发。
• LangChain：大模型应用开发框架，支持自定义提示词模板+项目规则注入，可封装AGENTS.md逻辑，打造专属项目AI助手。

3. 提示词/规则管理类（优化GPT指令，减少重复）

• PromptPerfect：AI提示词优化工具，输入基础指令，自动生成符合AGENTS.md规范的精准提示词，提升GPT输出质量。
• RulesManager：轻量规则管理工具，可视化编辑AGENTS.md/RULES，一键同步到项目根目录，支持团队共享规则模板。

4. 质量校验类（AI生成后自动校验，防违规）

• ESLint+AI插件：结合AGENTS.md规范，自动扫描GPT生成代码，标记不符合命名/格式规则的问题，一键修复。
• CodeRabbit：AI代码审查工具，内置AGENTS.md解析器，审查时自动匹配项目规范，给出精准修改建议。

五、总结：GPT项目好用的核心公式

GPT高效使用 = AGENTS.md（项目通用规范）+ RULES（IDE细粒度约束）+ 辅助工具（全流程提效）

AGENTS.md解决“AI不懂项目”的核心问题，RULES补全IDE专属细节，搭配Cursor/Copilot等工具，能让GPT从“凑活能用”变成精准对齐团队规范、直接可用的生产力工具。

下一步：立刻在项目根目录创建AGENTS.md，按模板配置规范，你会明显感受到——GPT生成的代码，终于“像自己人写的”。