---
title: 64KB 的 AGENTS.md，只有 10 行是项目规则
date: 2026-11-05
summary: 我以为把规则都写进 AGENTS.md 就够了，后来发现真正起作用的是一套三层结构：常驻记忆、可执行 skill、阶段门。
tags: [AI 协作, 规则, 工程化]
draft: false
---

做《小光头勇闯修真界》的第一天，我就写了一份很长的 `AGENTS.md`。
最后它长到 64KB——但打开一看，**真正属于「项目规则」的只有 10 行**。

剩下的全是托管策略和引擎 API 导航。这不是偷懒，而是后来才想明白的分层。

## 第一层：AGENTS.md 只放「每次都要知道」的

AI 每次会话都是冷启动。所以这一层只放三类东西：

1. **项目记忆**（10 行）：这个项目是什么、当前做到哪、哪些坑已经踩过
2. **托管策略**：哪些命令能跑、文件怎么组织、什么不能碰
3. **引擎导航**：API 在哪、示例在哪、别让 AI 自己发明用法

关键是第 1 类的「失败记忆」：每次踩坑，就把一条教训写回去。
项目结束时这里沉了 20 条——AI 跨会话不重复踩同一个坑，靠的就是它。

## 第二层：team-skills，把经验写成可执行规则

`team-skills/` 下是 5 个 skill、1055 行：产品切片、游戏手感、UI/UX、
资源生产、QA。它们不是文档，是**可执行的操作手册**——每个都写清楚了
「什么算合格」「用什么工具验证」「失败长什么样」。

而且这 5 个 skill 是唯一源，用 junction 链接到 `.agents`、`.claude`、
`.codex`、`.cursor`、`.gemini`——换哪个 AI 工具都读同一套规则，不会各写各的。

## 第三层：阶段门，用「唯一产物」约束 AI

最有效的一条：**把流程切成 7 个阶段，每个阶段只有一个合法产物**。
Brief → Concept → Prototype → Design → 生产 → Art/Asset → QA 报告。

AI 每次只读当前阶段需要的文件，不允许提前读后面的，
更不允许一次把全套策划写完——那样它会在没验证的假设上狂奔。

派单时还要写清楚「写入范围」：谁来改 balance、谁来改 audit、谁只写 docs。
多个 agent 并行时，这一条能避免 90% 的互相覆盖。

## 一句话

给 AI 写规则，不是为了限制它，而是为了**让它的产出可以被验收**。
规则分层之后，AI 才从「会写代码的实习生」变成「能独立交付的组员」。