和 AI 长期协作做项目，我把Agent存储架构规则迭代到了 V8.2-云帆数科

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 分钟的甜头你再回来找我要剩下的。最后说两句题外话这套东西写出来其实挺暴露自己的——它等于公开承认我一个人根本管不住多线并进的工程得靠一份文件替我记得所有事。但转念一想这不就是工具的意义吗。以前靠记性现在靠体系。省下来的精力放在真正要做决策的地方。有什么想聊的评论区见。整理不易如果这套思路对你有启发欢迎转发给那个文件永远找不到的朋友。

企业数字化 ERP 产品动态

相关推荐

用STM32 SPI+DMA实现XY2-100振镜协议控制详解

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 12:29:40

Docker部署XXL-JOB完整指北：从分布式任务调度到时区避坑

为了研究Redis 三大守护神，我做了一个本地模拟！

Kill-redis-plan 本地模拟缓存击穿、缓存穿透、缓存雪崩，用于研究redis缓存开源网站自行🔍本地复现 Redis 缓存穿透、击穿、雪崩。注意力在缓存层：Compose 只跑 Redis，存储用进程内 FakeDB，用 Go goroutine 打并发。 … · 2026/9/24 12:29:40