驾驭工程：让AI不再挖坑

有没有遇到过这些情况？

新开一个对话，AI忘了上周定的架构，你又解释一遍。迭代几十次后，代码慢慢“长歪”，规则形同虚设。设计文档和实际代码越来越不像，等发现时已积重难返根本原因只有一个：AI的记忆会衰减，文件不会。下面是我在8万行代码项目里总结的可以参考也可以直接复制粘贴过去，希望对你有用。

驾驭工程：AI 协作项目长期治理方法论 适用场景：长期维护项目 / 代码量 3 万行以上 / 与 AI 深度协作开发 为什么需要它 你有没有遇到过这些情况： 新会话开始，AI 忘了上次的决定，你又解释了一遍 迭代几十次后，代码慢慢写歪，规则形同虚设 实现和设计文档越来越不一样，等发现时已经积累很深 根本原因只有一个：AI 的记忆会衰减，文件不会。 驾驭工程的核心思路就是：把所有应该让 AI 记住的东西，从它的上下文里搬出来，写进文件里。 四个面 01 上下文工程 问题：新会话 AI 不知道在哪，靠你口头同步，浪费 15 分钟以上。 方案：在项目根目录建 AGENTS.md 这个文件是 AI 每次新会话的"第一步强制阅读"，内容包括： 必读文件列表（按顺序） 项目目录速查表 当前版本和紧急待办 读完后的输出格式（恢复报告） 模板结构： #  AGENTS.md — 新会话定向文件 > 每次新会话开始时必读此文件，5分钟内完成定向，不得跳过。 ##  第一步：快速定位（必须做） 读以下文件，顺序不变： 1. docs/记忆索引.md 2. docs/用户画像.md 3. docs/协作协议.md 4. docs/架构约束.md 读完后输出： 【记忆恢复】 项目：xxx | 版本：xxx 上次完成：xxx | 当前待办：xxx 等待指令。 ##  项目快照（每次更新记忆时同步更新） - 游戏：xxx | 技术栈：xxx - 版本：xxx | 紧急待办：xxx 落地中可能遇到的问题： AI 读了文件但没输出恢复报告 → 在 AGENTS.md 里写"不输出恢复报告 = 违规" 项目快照过期 → 规定每次 POST 时同步更新此处 02 架构约束 问题：你口头说过"UI 和逻辑要分离"，但上下文一压缩，AI 就忘了，规则只活在聊天里。 方案：建 docs/架构约束.md，≤ 15 行精华版 不要写长篇大论，只写"违反了会出问题"的硬规则，每条一句话。 模板结构： #  架构约束 > 违反 = 输出 [ARCH_VIOLATION] | 最后更新：日期 ##  目录职责 | 目录 | 负责什么 | 不放什么 | |------|---------|---------| | core/ | 纯逻辑 | UI代码、配置文本 | | ui/  | 纯渲染 | 业务逻辑、数值计算 | | data/| 纯数据 | 逻辑判断、UI操作 | ##  硬规则（≤ 10条） 1. 修改高风险文件前必须输出 [EDIT_PLAN] 2. 事件 ID 必须与设计文档一一对应，不得自创 3. UI 组件只用指定库，禁止用原生 API ... 落地中可能遇到的问题： AI 违反规则但没主动报 [ARCH_VIOLATION] → 在规则里明确写"自查触发条件" 规则越来越多超过 15 行 → 严格执行：每加一条必须删一条不再需要的 03 前置声明 问题：AI 动手前没对照文档，写完才发现方向跑偏，修复成本极高。 方案：对高风险操作设置强制声明检查点 在协作协议里规定：修改核心文件前，必须先输出 [EDIT_PLAN]，格式如下： [EDIT_PLAN] 本次修改涉及文件：xxx 对照设计文档：xxx §章节 计划变更内容：[列出] 会影响的模块：[列出] 与已有内容的衔接点：[说明] 不输出此声明就开始写代码 = 架构违规。 落地中可能遇到的问题： AI 输出了声明但内容是空话（"按照需求修改"之类）→ 要求必须引用具体文档章节和行号 AI 对"高风险文件"的判断和你不一致 → 在架构约束里明确列出哪些文件是高风险文件 04 后置对账 问题：AI 只汇报"做了什么"，不说"偏离了什么"，偏差积累到某天才集中爆发。 方案：每批工作完成后强制输出 [WORK_DIFF]，格式如下： [WORK_DIFF] 本批变更：[列出变更内容] 设计文档对应章节：[引用] 实现了哪些设计意图：[逐条] 偏离或简化了哪些：[逐条，说明理由] 遗留未实现：[列出，附优先级] 落地中可能遇到的问题： “偏离"一栏 AI 总写"无偏离” → 在协议里写"若无偏离需说明理由，否则视为未认真填写" 遗留清单越来越长没人管 → 规定每次 [EDIT_PLAN] 时必须先消化上一次的遗留 P0 项 部署顺序 — 不要一次推四个 建议分周落地，每一步验证生效后再加下一个： 第 1 周：只部署 AGENTS.md → 验证标准：AI 新会话是否真的读了，是否输出恢复报告 第 2 周：加 架构约束.md → 验证标准：AI 是否能主动检测并报告 [ARCH_VIOLATION] 第 3 周：加前置声明 → 验证标准：声明里是否有真实的文档引用，不是空话 第 4 周：加后置对账 → 验证标准：偏离栏是否如实填写，遗留清单是否有人管 关键差距 无驾驭工程 有驾驭工程 会话恢复 随机，质量不稳定 5 分钟结构化恢复 架构规则 随上下文消失 写在文件里永久有效 错误时机 事后发现，修复成本高 动手前截获，成本接近零 偏离追踪 靠 AI 记住，易丢失 每批次显式输出，有记录 指挥官负担 每次重新同步 15 分钟+ 确认报告 3 分钟内 把规则写进文件，不让它随上下文消失。 AI 的内存会衰减，文件不会。 欢迎大家给出使用后的反馈如何