For AI agents: the complete documentation index is at llms.txt. Markdown versions of any page are available by appending .md to the URL path.

AI Agent 开发的三大模式

技术AI Agent

Build 模式:直接进入执行

给定目标后,Agent 立刻开始改代码,边写边跑测试,遇到问题自己修,直到任务看起来完成。人只在开头给需求,在结尾验收。

它适合边界清楚、改错代价低的任务:修一个症状明确的 bug、补一个小功能、写一个用完就丢的原型、调整一段独立的样式。

一个实用判断:如果这次改动的结果你五分钟内能看懂,Build 通常划算

Plan 模式:先调研再动手

Agent 输出一份可评审的方案:要改哪些文件、每一步做什么、有哪些风险和不确定项、需要什么权限。人确认目标和权限边界后,才允许它写代码。

执行过程中仍然会调整,所以沟通不是一次性的。方案也不是交付物,它只是把决策提前摊开。

Plan 适合改错代价高的任务:跨模块重构、数据模型调整、涉及权限或外部系统的改动、多人同时修改的代码区域。

Goal 模式:规格驱动开发

Goal 模式把人的工作集中到规格阶段。适合完整的模块化或项目级需求,在最初阶段会进行需求分析和系统设计。

人定义目标、边界和验收标准,Agent 在一个循环里执行、自测、修复,直到所有验收条件通过。

三种模式的真正差别

维度 Build Plan Goal
介入时机 开始和结束 执行前审核,过程中调整 规格阶段和最终验收
沟通频率 最低 最高 低
前置成本 低 中到高 高,主要在规格和测试
主要风险 方向跑偏,返工大 方案与实现脱节 规格遗漏,优化错误目标
成立条件 任务边界清楚 方案可评审 验收可自动验证

模式可以组合,但判断责任不能转移

三种模式看起来是在分配 Agent 的自主权,实际上是在分配人的判断责任。

Build 把判断留在结尾,所以要求任务本身足够小。

Plan 把判断放在执行之前,所以要求方案足够真实。

Goal 把判断压缩成验收标准,所以要求规格足够完整。