为什么 AI 项目越来越需要 AGENTS.md？

为什么 AI 项目越来越需要 AGENTS.md？

文章目录

• [为什么 AI 项目越来越需要 AGENTS.md？](#为什么 AI 项目越来越需要 AGENTS.md？)
• [真正的问题不是 AI 不够聪明](#真正的问题不是 AI 不够聪明)
• [我没有给 AI "工程规则"。](#我没有给 AI “工程规则”。)
• AGENTS.md
• [给 AI 的项目开发规范。](#给 AI 的项目开发规范。)
• [告诉 AI：](#告诉 AI：)
• [一个好的 AGENTS.md 应该包含什么？](#一个好的 AGENTS.md 应该包含什么？)
• [1. AI 工作规则](#1. AI 工作规则)
• [2. 项目定位](#2. 项目定位)
• [3. 项目结构](#3. 项目结构)
• "代码应该放哪"。
• [4. 数据规范](#4. 数据规范)
• [5. UI 和动画规范](#5. UI 和动画规范)
• [6. 禁止事项](#6. 禁止事项)
• [AI 的安全护栏。](#AI 的安全护栏。)
• [AGENTS.md 真正的作用是什么？](#AGENTS.md 真正的作用是什么？)
• [它是在统一 AI 的长期行为。](#它是在统一 AI 的长期行为。)
• ["会设计 AI 工程规范"。](#“会设计 AI 工程规范”。)

这段时间我一直在用：

• ChatGPT
• Claude
• Cursor
• Codex

辅助开发项目。

一开始体验确实很好：

"帮我写个页面"
"帮我做个弹窗"
"帮我加个动画"

AI 基本都能完成。

但项目一旦开始变大：

问题就来了。

比如：

• AI 开始乱改目录
• hooks 到处乱放
• mock 数据写满页面
• UI 风格越来越不统一
• 页面越来越大
• 动画越来越卡

后来我发现：

真正的问题不是 AI 不够聪明

而是：

我没有给 AI "工程规则"。

于是我开始写：

AGENTS.md

它本质上就是：

给 AI 的项目开发规范。

不是 README。

不是项目介绍。

而是：

告诉 AI：

这个项目是什么
代码应该怎么组织
什么能做
什么不能做

的一套规则。

---

一个好的 AGENTS.md 应该包含什么？

其实不用特别复杂。

核心大概有这几个部分：

---

1. AI 工作规则

例如：

- 修改前先读代码
- 不允许乱重构
- 修改范围最小化
- 修改后运行 lint

这是为了防止 AI：

"顺手把整个项目改了"

---

2. 项目定位

例如：

这是一个多人在线游戏大厅项目

因为：

AI 会根据这个：

决定 UI 风格和代码结构。

否则：

很容易给你生成：

后台管理系统风格

---

3. 项目结构

这是最重要的一层。

例如：

src/
├── modules/
├── components/
├── hooks/
├── stores/

它会告诉 AI：

"代码应该放哪"。

否则：

后面一定会：

components2/
shared/
widgets/

乱飞。

---

4. 数据规范

例如：

禁止页面直接 fetch

正确方式：

hooks
stores
mock

这样后面才方便维护。

---

5. UI 和动画规范

例如：

项目是高沉浸感游戏风格

以及：

动画优先使用：
transform
opacity

这样 AI 后续生成的页面：

风格才会统一。

---

6. 禁止事项

这个非常重要。

例如：

禁止 any
禁止大规模重构
禁止实现未规划功能

这其实是：

AI 的安全护栏。

---

AGENTS.md 真正的作用是什么？

很多人以为：

它只是：

"AI 项目说明"

但实际上：

它是在统一 AI 的长期行为。

项目越大：

越需要它。

因为未来的软件开发：

越来越像：

人负责规则
AI 负责实现

所以：

真正重要的能力：

已经不只是：

"会写代码"

而是：

"会设计 AI 工程规范"。