194 行,15 节,7 条黑名单,9 项自检项,8 个版本。
这是我过去半年维护的一份 Markdown 规则文件。它一行代码都没有,却管着我和 AI 协作的所有工程:目录怎么建、文件怎么命名、日志怎么记,以及——AI 不准干什么。
先说一个反直觉的结论:
和 AI 协作做项目,先崩的通常不是模型能力,是文件系统。
先说说我遇到的问题
如果你也拿 AI 做过稍微长期一点的项目,下面这些场景大概率不陌生:
- 新开一个会话,AI 不知道文件在哪、规则在哪、工程进度到哪一步,你得一五一十重新交代;
- 隔几周自己回来,也要翻半天聊天记录才能想起"当时为什么这么决定";
- 规则散在各处——有的写在一个工程的文档里,有的只靠对话口头约定,换个 AI 就全丢;
- 头疼的是,AI 热情很高但边界感差:不确认就写文件,顺手"整理"它觉得没用的目录,把项目代码和文档搅在一起。
我试过在每次对话开头手动交代背景。太累了,而且治标不治本。
后来我做了件事:把"怎么存文件"本身规则化,写成一份独立的规则文件,人和 AI 共用。
一、架构本身:一个根目录,三个支柱
整个系统就一个根目录,三个支柱:
D:\MyAgent\(工作根目录) ├─ Agent_Rule.md —— 框架规则(只存放跨工程的规则) ├─ 总索引.md —— 纯导航索引 ├─ 工程\ —— 每个工程一个目录,装该工程的全部档案 ├─ 项目\ —— 真实项目代码所在地 └─ SKILL\ —— 可复用的工作方法、流程、模板三个支柱各管一摊:
| 支柱 | 放什么 | 硬约束 |
|---|---|---|
| 工程\ | 档案:简介、详情、规则、日志 | 只放档案,不放代码 |
| 项目\ | 真实项目代码 | 与工程目录类别名一一对应 |
| SKILL\ | 可复用技能(每个技能一个 SKILL.md) | 按技能类型独立分类 |
每个工程目录下有三个文件名不得更改的文件:工程简介、工程详情、源工程路径。固定文件名的意思很简单——AI 的检索路径是确定的,不用猜这个工程的简介叫什么。
还有一个反直觉的设计:惰性细分。初始只建一层目录,不预分类;等某个文件混了多个主题,才拆。提前设计的分类树一定会错,因为你不知道未来会长出什么。
二、真正值钱的设计决策
这套架构跑下来,回头看,真正值钱的不是目录树,是下面几个决策。
档案与代码分离。工程目录因此非常轻,全是文本档案;整个根目录拖走就是完整系统。AI 检索先读轻量档案,需要代码时顺着"源工程路径"跳转。
总索引只当导航,不当流水。索引里只有一行梗概 + 通用注意事项,事件流水、决策过程一律下沉到各工程的日志文件。配套一条失步恢复规则:索引和实际目录对不上时,以实际为准修复,并留一条修复记录。为什么强调这个?因为索引一旦没人管,比没有索引更糟——它会让你信错。
写入前先确认。任何新建、修改、删除,AI 必须先向我说清楚要存什么,等我点头才动手。“你先做着看”"随便"都不算授权,直接写进了黑名单。
三、表面是文件规范,暗线是 AI 行为约束
但如果你只看到目录结构,就浅了。
这套文件真正花心思的地方,是它把 AI 最容易越界的行为,一条条写死了:
不得凭记忆操作。拆书、分析必须有真实文本输入,没有就停下来要,不许编造。这一条看着简单,救过我很多次——AI 为了不显得"没用",最容易在无源的情况下硬答。
不得擅自迁移或删除。发现结构不一致,先告知,等确认。AI 太喜欢"顺手优化"了,而很多目录的混乱恰恰是优化出来的。
写入前必须描述清楚。主方向、小方向、细节,三句话说清要干什么。我点头,或者我事先给过明确授权范围,才准动手。
索引失步要修复并留痕。实际目录和总索引对不上时,以实际为准,补索引,并记一条"失步修复"。不许假装没发生。
同一操作失败 2 次就停手。不准无限重试,不准静默换目标。先报告,等我决策。
这些规则的本质是什么?一句话:
它们不是在管文件,是在管 AI 的"手"——什么时候能伸,伸之前要说什么。
文件系统本身不会乱。乱的源头,是人图省事、AI 图表现。
四、半年下来,我得到了什么
说几个实在的:
任何新 AI 零成本接手。规则文件扔过去,读完即懂,不用我陪跑前半小时。
工程中断后随时续上。总索引 + 工程简介 + 日志,三段式检索,5 分钟内恢复上下文。以前这个项目搁置两周再捡起来,光回忆就要大半天。
踩坑只踩一次。每次事故都变成一条新规则或一条黑名单,同类错误基本绝迹。规则文件从 V1 长到 V8.2,就是这么长出来的——不是设计出来的,是撞出来的。
AI 更敢用了。这个可能反常识。边界越清楚,我交给 AI 的活越多——因为我知道它不会做什么,比知道它能做什么更重要。
五、如果你也想试,最小起步清单
不用照搬整套。挑三条先跑起来:
- 固定三件:每个项目一个简介、一个详情、一个源路径,文件名死规定;
- 一个总索引:只写导航和一行梗概,别当记事本;
- 写入前确认:AI 动文件前,必须先说清干什么。
这三条一周内就能见效。等尝到"续上下文只要 5 分钟"的甜头,你再回来找我要剩下的。
最后说两句题外话
这套东西写出来,其实挺暴露自己的——它等于公开承认,我一个人根本管不住多线并进的工程,得靠一份文件替我记得所有事。
但转念一想,这不就是工具的意义吗。以前靠记性,现在靠体系。省下来的精力,放在真正要做决策的地方。
有什么想聊的,评论区见。
整理不易,如果这套思路对你有启发,欢迎转发给那个"文件永远找不到"的朋友。