← 术语图鉴

规则文件

Rules File (AGENTS.md / CLAUDE.md) · 也叫 AGENTS.md / CLAUDE.md / 项目说明文件

放在项目里、AI 工具每次开工都会自动读的说明文件:写着这个项目的约定、禁区和常用命令。

你可能会说:

  • “每次开新对话都要把项目要求重讲一遍,有没有办法省掉?”
  • “仓库里那个 CLAUDE.md、AGENTS.md 是干什么的?”

它是什么

Codex 会读项目里的 AGENTS.md,Claude Code 会读 CLAUDE.md。每开一个新会话,这些内容都会进到它的上下文里,不用你每次重讲。

适合写进去的是长期有效的东西:项目结构、写法约定、不许碰的目录、怎么构建和测试。只对这一次任务有用的进度和计划,写进单独的交接文档,做完就更新或删掉。

每个会话都会读到它,所以写错了危害也大:过时的规则会被当真。改动它要像改代码一样留记录,并且经你确认。

打个比方

像贴在工位上的一张便条:不管谁来坐这个位子,第一眼都能看到。

在这个网站里

这个网站的仓库里有一份 .claude/CLAUDE.md,规定每个文件夹都要有一份三行以内的说明、每个文件开头都要写三行注释(依赖什么、提供什么、在哪一层)。在这个仓库里开工的每个 AI 会话,都会读到它(第 20 课)。

容易搞混的地方

常见误解

AI 会记住上次对话里定下的规矩

正确理解

新会话只知道规则文件和你这次说的话。要它一直遵守的,写进规则文件。

你可以这样告诉 AI

复制下面这段,贴给你的 AI

把这个项目长期有效的约定整理进规则文件:结构、写法、禁区、构建与测试命令。只和这次任务有关的进度,另写一份交接文档。

先知道

  • 上下文窗口——模型一次能"看见"的文字上限。超出的部分,要么被截掉,要么被压缩成摘要。

接着看

  • Skill——一份写好的"遇到这类任务就这样做"的说明书,AI 在需要时自己读取、照着执行。

在这些课里出现