AI 自动化:从对话到契约

别再对着对话框“盲目敲码”了：规范驱动才是 AI 编程的终点

现在的开发者分两类。第一类每天对着大模型疯狂敲入“帮我写个登录界面”或者“重构这段逻辑”，然后盯着屏幕看代码飞速生成。这感觉很爽，直到几周后，系统因为上下文幻觉开始崩溃，代码实现跟最初的架构南辕北辙。

这叫“氛围编程”（Vibe Coding）。看起来一切都在推进，实际上技术债正像雪球一样越滚越大。

第二类开发者正在转向一种更冷峻、更确定的模式：文件规范驱动开发。他们不再把 AI 当成全知全能的神，而是将其看作一个需要严格说明书的操作员。

扔掉对话记录，拿起 Markdown

让 AI 记住长达一个月的对话历史纯属痴心妄想。模型会遗忘，会产生逻辑偏移。

聪明的做法是把所有的“意图”固化在物理文件里。不再是“我记得我上次说过…”，而是直接让智能体去读根目录下的那个 .md 文件。在这个体系里，Markdown 不再是写完就扔的文档，它是驱动代码生成的“元源代码”。

整个架构被切成了四块。最顶层是“宪章”，里头写死了一些不准触碰的红线，比如“禁止使用任何未经授权的第三方库”。往下是业务规范、技术蓝图和任务清单。每一层都在为下一层“喂”确定性。

让智能体在沙盒里“互殴”

如果把产品经理、架构师和程序员智能体全都塞进一个读写权限全开的目录，代码库第二天就会变成一堆废纸。

现在的套路是“角色隔离”。产品智能体只能搜关键词、读文件，哪怕它想改一行代码也办不到。执行智能体虽然能写代码，但它被关在一个无状态的沙盒里，连宿主机的环境变量都摸不到。

它们怎么协作？靠一份叫 AGENTS.md 的协议。

这份协议就像一张导航地图。智能体每走一步，都要先看一眼地图：我现在在哪里？我有没有越权？如果它发现需求定义模糊，或者找不到外部依赖的凭证，它必须立刻停手，乖乖等人类干预。它不能“自作聪明”地伪造数据。

所谓的“爆炸半径”

当 AI 打算重构一段核心逻辑时，风险是指数级的。

资深专家会引入一个概念：爆炸半径。如果这次变更只涉及几个原子文件，那就让 AI 并行去干，效率拉满。但如果变更涉及跨模块的深层依赖，工作流会强制切回顺序模式。

智能体在动手改文件之前，必须先交出一份“实施路径分析报告”。这就像拆弹专家在剪线前先画个电路图。只有等人类或者架构智能体点过头，那个真正的“写操作”才会触发。

别让代码跑得比规范快

最让人头疼的问题是“规范漂移”。

AI生成代码的速度太快了。它可能为了性能优化悄悄改了一个接口，但根本没去更新对应的OpenAPI文档。久而久之，文档就成了骗人的鬼话。

现在的自动化流水线里专门养了一批“追溯守护智能体”。它们的工作很枯燥但极度重要：把最新的源码解析成抽象语法树，然后去跟最初的需求文档做高维语义比对。

一旦发现代码里出现了文档没提到的“幽灵逻辑”，或者需求里要求的某个边界检查在代码里离奇失踪，流水线会直接亮红灯。这种铁腕阻断是防止系统长期腐化的最后一道防线。

告别“代码行数”的度量时代

衡量这套系统行不行，还在数代码行数或者提交次数？那太落伍了。

现在的硬指标是“任务收敛步数”。如果一个智能体解决一个Bug需要绕十几个弯，调用一堆无关工具，那说明你的全局宪章写得烂透了，上下文充满了歧义。

另一个指标是“路径折返率”。智能体写了删、删了写，或者在同一个逻辑死循环里打转，这就是在烧你的Token。

结语

软件工程正在经历一场从“命令式”到“声明式”的搬迁。

大模型决定了能力的下限，而你为它设计的工作流规范，才决定了产出的上限。当自然语言规范变成了真正能指挥智能体集群的“元代码”，AI 就不再是一个只会猜概率的生成器，而是一个守规矩、可追溯的工程伙伴。

它不休息，不抱怨，只要你给它的那份Markdown契约足够清晰。