64KB 的 AGENTS.md，只有 10 行是项目规则

做《小光头勇闯修真界》的第一天，我就写了一份很长的 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 才从「会写代码的实习生」变成「能独立交付的组员」。