夜雨聆风你是不是也有过这样的经历：
打开Cursor、Copilot这些AI编程工具，兴冲冲地想让它帮你写代码，结果——要么生成的代码完全不是你想要的，要么改了一行把整个文件搞崩了。
问题不在AI，而在你没给它"说明书"。
今天这篇文章，我手把手教你配置一个真正听话的AI编程Agent。不需要写代码，跟着截图做就行。
很多人用AI编程工具的方式是：直接打开，开始提问。
这就像你招了一个实习生，第一天来就让他干活，但不告诉他项目规范、代码风格、技术栈——他当然会搞出一堆问题。
AI Agent也一样，需要一份"入职手册"。
在业界，这份手册叫 AGENTS.md（Agent配置文件）。它告诉AI：
你的项目用什么语言和框架 代码风格是什么样的 哪些文件不能碰 遇到问题该怎么处理
目前主流的AI编程工具都支持类似的配置：
| 工具 | 配置文件名 | 支持程度 |
|---|---|---|
| Cursor | .cursor/rules |
⭐⭐⭐⭐⭐ |
| GitHub Copilot | .github/copilot.md |
⭐⭐⭐⭐ |
| Windsurf | .windsurfrules |
⭐⭐⭐⭐ |
| Claude Code | CLAUDE.md |
⭐⭐⭐⭐⭐ |
第1步：在项目根目录创建配置文件
以Cursor为例，在你的项目根目录下创建 .cursor/rules 文件：
你的项目/
├── .cursor/
│ └── rules ← 就是这个文件
├── src/
├── package.json
└── ...
第2步：写入基础配置模板
把下面这段配置复制进去，根据你的项目修改：
# 项目概述
这是一个[你的项目类型]项目，使用[技术栈]开发。
# 代码规范
- 使用 TypeScript 严格模式
- 变量命名使用 camelCase
- 组件命名使用 PascalCase
- 每个函数不超过 50 行
- 必须写注释，尤其是复杂逻辑
# 文件结构
- src/components/ — 存放UI组件
- src/utils/ — 存放工具函数
- src/api/ — 存放接口调用
- src/store/ — 存放状态管理
# 禁止操作
- 不要修改 package.json 的依赖版本
- 不要删除现有的测试文件
- 不要修改 .env 配置文件
# 遇到问题时
- 先检查现有代码中是否有类似实现
- 优先使用项目已有的工具函数
- 不确定的地方用注释标注 TODO
第3步：验证配置是否生效
打开你的AI编程工具，输入一个简单指令：
"帮我写一个用户登录表单组件"
没配置前：AI可能给你一个通用的React组件，风格和你项目完全不同。
配置后：AI会按照你定义的文件结构、代码风格、技术栈来生成代码，直接能用。
第4步：逐步优化你的配置
用了几天后，你会发现一些问题，比如：
AI总是引入你不想用的库 → 加到"禁止操作"里 AI生成的代码缺少错误处理 → 加到"代码规范"里 AI不知道你的API格式 → 加到"项目概述"里
配置文件是活的，要持续迭代。
秘诀1：给AI"看"你的代码示例
在配置文件中加入示例代码：
# 参考代码
写新组件时，参考 src/components/Button.tsx 的写法：
- 使用 forwardRef
- 导出 Props 类型
- 使用 className 合并工具
秘诀2：设置不同场景的规则
# 场景规则
- 当我说"快速实现"时，可以跳过部分注释
- 当我说"正式提交"时，必须包含完整注释和测试
- 当我说"重构"时，不要改变功能，只优化代码结构
秘诀3：让AI学会"拒绝"
# 安全规则
- 如果需求涉及用户隐私数据处理，提醒我注意合规
- 如果修改会影响超过10个文件，先列出修改计划让我确认
- 如果不确定需求含义，先提问再动手
Q：配置文件会影响AI的性能吗？
A：会占用一部分上下文窗口，但好处远大于成本。建议配置文件控制在500行以内。
Q：团队协作时怎么处理配置文件？
A：把配置文件提交到Git仓库，团队共享。每个人可以在此基础上加自己的个人偏好。
Q：不同项目可以用同一份配置吗？
A：基础部分可以复用，但项目特定的部分（文件结构、技术栈等）需要每个项目单独配置。
AI编程工具不是魔法，它需要你告诉它"怎么做"。
一份好的Agent配置文件，就是你和AI之间的"默契"。配置得越好，AI给你的结果就越精准。
今天就试试吧： 打开你的项目，花5分钟写一份 .cursor/rules，你会发现AI助手突然"开窍"了。
觉得有用？点个「在看」，让更多人学会高效使用AI编程工具 👇
