前言

最近我一直在用 AI 开发骰子游戏项目。

从最开始的 Claude Code，到后来使用 trae、gtp，各种 AI 编程工具基本都体验了一遍。

刚开始的时候，我觉得 AI 非常强。

一个页面、一个组件，几句话就能生成。

但随着项目往后推进，我开始遇到一个很头疼的问题：

AI 很聪明，但它不懂我的项目。

---

AI 最大的问题不是不会写代码

而是不懂上下文

比如同样让我生成一个页面。

有时候它会：

• 使用 Zustand

可能下一次又变成：

• Redux

我不断重复告诉它：

用 Redux

用 TypeScript

不要用 any

结果下一次对话又忘了。

那个时候我开始意识到：

AI 并不缺编码能力。

缺的是项目记忆。

---

后来我开始频繁看到一个词

AGENTS.md

当时我在看很多关于AI开发项目的文章。

发现一个词出现频率特别高：

AGENTS.md

最开始我并没有太在意。

后来越来越多开发者开始提到它。

于是我专门去了解了一下。

结果发现：

它恰恰就是我一直在寻找的东西。

---

AGENTS.md 到底是什么

如果让我用一句话解释：

AGENTS.md 就是一份写给 AI 阅读的项目开发规范。

它不是写给程序员看的。

而是写给 Claude Code等AI工具看的。

它告诉 AI：

• 这个项目用什么技术栈

• 目录应该怎么组织

• 状态管理用什么

• 请求怎么写

• 哪些规则必须遵守

例如：

- React 19
- TypeScript
- Ant Design
- Axios
- Zustand

禁止使用 Redux
禁止使用 any

当 AI 读取到这些规则后。

生成代码时就会按照这些规范执行。

---

它解决的其实不是代码问题

而是协作问题

很多人把 AI 当成代码生成器。

但随着 Agent 越来越强。

它更像是一个团队成员。

问题来了。

如果一个新同学加入项目。

你总不能每天告诉他：

我们用 React

我们用 TypeScript

我们接口放 services

我们不用 Redux

同样的道理。

AI 也需要项目规范。

而 AGENTS.md 就承担了这个角色。

---

后来我给项目写了第一个 AGENTS.md

内容其实非常简单。

比如：

# Project

- Next.js
- React 19
- TypeScript
- Ant Design

# Rules

- 使用 interface
- 禁止 any
- 禁止内联样式

# API

- 请求统一放 services

# Game Rules

- 骰子由后端生成
- 胜负由后端计算

结果让我有点意外。

之后生成的代码明显稳定了很多。

很多以前反复提醒的问题。

AI 自己就遵守了。

---

我觉得它更像 Prompt 的进化版

以前我们写 Prompt：

使用 TS

使用 Zustand

不要使用 any

每次开新对话都要重新说。

而 AGENTS.md 更像：

项目级别的永久 Prompt。

只要文件存在。

AI 就能不断读取。

不用每次重新解释。

---

一句话让我印象特别深

在看一位开发者文章的时候。

他提到一句话：

未来 AGENTS.md 才是真正体现开发者能力的地方，而代码本身更像编译产物。

第一次看到的时候我觉得有点夸张。

但仔细想想。

又觉得很有道理。

过去我们的价值是：

自己写代码。

未来随着 Agent 能力越来越强。

开发者更多是在定义规则、架构和约束。

AI 负责执行。

这时候决定项目质量的。

可能已经不是你敲代码的速度。

而是你是否能够设计出一套优秀的工程规则。

从这个角度看。

AGENTS.md 确实越来越像项目的“源代码”。

而 AI 生成出来的代码。

反而像根据这些规则编译出来的结果。

---

我还在学习如何写好 AGENTS.md

说实话。

我现在的 AGENTS.md 也并不完美。

很多内容都是一边踩坑一边补充。

例如：

• 目录结构规范

• API 请求规范

• 状态管理规范

• 业务规则约束

这些都是项目开发过程中慢慢积累出来的。

我相信以后还会不断调整。

不断迭代。

---

结语

以前我认为：

AI 编程最重要的是 Prompt。

现在我越来越觉得：

Prompt 决定一次输出。

而 AGENTS.md 决定整个项目的输出。

对于使用 Cursor、Claude Code 等 Agent 工具开发的人来说。

AGENTS.md 可能会逐渐成为项目中最重要的文件之一。

至少对于现在的我来说。

它已经开始解决那些单纯依靠 Prompt 无法解决的问题了。