logo

手写编程与Agent编程:差异、边界与选型建议

作者:c4t2026.11.16 10:48浏览量:0

简介:同样是“用 AI 写代码”,有人仍要求自己看懂每一行,有人只保留架构与验收职责、把实现交给 Agent。本文对比“人工主导 + 补全辅助”(方案 A)与“Agent 自主编程”(方案 B)两种开发模式,从底层技术同源、代码理解与责任边界、上下文组织方式、失败模式、验证成本、安全合规、运维与迁移成本等维度拆解差异,给出典型场景与条件化选型建议,并说明模式切换时必须提前评估的风险。

一、对比背景:争议的焦点不在工具,而在“人承担什么”

某高校开设的 AI 辅助软件工程公开课程,在国内开发者社区引发了持续讨论。其中被反复引用的一个判断是:你不会被 AI 取代,但你会被一个会用 AI 的工程师取代。这个结论之所以刺痛人,是因为它把一个长期被回避的问题摆到了桌面上——当实现代码这件事的边际成本快速下降时,工程师的价值锚点究竟落在哪里。

围绕这件事出现了两种截然不同的情绪。一种是抵触:把代码交给模型,等于放弃手艺。另一种是激进:全面转向“让 Agent 写”,人只提需求。真正有价值的问题不是这两种情绪谁对,而是:这两种工作方式在技术机制上到底差在哪里,各自的适用边界在哪里,以及一个团队在什么条件下应该往哪一侧移动。

需要先澄清一个常见误解:两种模式的差异,不在于用的模型谁更强,也不在于工具是否“更先进”。它们的底层能力来源高度一致,差别在于人把哪些工作留在自己脑子里、哪些交给外部系统,以及由此产生的验证成本与风险结构完全不同。这才是本文对比的主线。

二、对象定义:两个对比对象分别是什么

方案 A:人工主导 + 补全辅助模式

工程师是代码的主要生产者,AI 承担两类轻量职责:一是行级或片段级补全(根据当前文件上下文预测接下来要写的若干 token),二是对话式问答(解释一段逻辑、给出某个接口的候选写法、帮忙定位报错)。代码的结构、命名、控制流、边界处理由人决定,产出物是工程师心里“应当如此”的实现,AI 只是加速了键盘输入与检索过程。

方案 B:Agent 自主编程模式

工程师下达的是任务描述而非实现指令。Agent 运行在一个带工具的外壳里:它可以读取仓库文件、检索代码、按目录约定定位模块、执行命令(编译、测试、格式化)、观察执行结果并据此修正自己的输出,在一个多步循环里逐步逼近目标。人的工作重心从“写”转移到拆需求、审架构、管上下文、验结果。业内有时用“氛围编程”来形容这种工作方式,但它并不是“凭感觉”,而是职责重心的一次重新划分。

两者共同的底座:同一个“填词游戏”

无论哪一种模式,底层跑的都是大语言模型,其本质动作都是:给定前文,预测下一个最可能的 token。这个能力经过三个阶段被打磨成“看起来什么都懂”的形态:

  1. 预训练:用互联网上近乎全量的文本训练语言与世界的统计规律,算力与数据投入极高,行业里单次预训练的投入通常以百万美元量级计;
  2. 监督微调:用人工标注的问答对,教模型遵循指令、按预期格式作答;
  3. 偏好对齐:通过人类偏好比较来调校输出,让回答更接近一个可靠助手而非随机话痨。

正因为底座相同,两种模式共享同一类硬伤:幻觉——模型会以非常自信的语气编造不存在的 API、不存在的库、参数签名看起来合理但实际不对的函数,以及在真实代码库里并不成立的调用路径。方案 B 只是把幻觉的影响面放大了,而不是引入了新类型的错误。这是全文最重要的一条判断依据。

三、相同点:它们共享的约束

  1. 能力来源相同。两者都不具备独立于大模型的“智能”,上限都受基座模型能力与上下文窗口限制。
  2. 都受上下文质量约束。无论哪种模式,模型只能看到你给它的部分。项目里的隐式约定(为什么这个字段不能改、这个函数为什么这样实现、线上有什么历史包袱)不写进上下文,输出就一定偏离。
  3. 责任主体仍然是人。需求拆解、架构决策、结果验收、事故兜底,在任何模式下都不可外包给模型。差别只是方案 B 让人更容易误以为可以外包。
  4. 都必须面对不可验证的代码。两种模式都可能产出语法正确、风格正常、但语义错误的代码,尤其涉及并发、事务边界、边界条件、异常路径时。
  5. 都依赖工程规范作为隐性输入。目录约定、命名规范、日志规范、测试框架、错误处理约定,写得越清楚,两种模式的产出质量都越高。
  6. 效果都随任务边界清晰度提升。需求描述模糊时,方案 A 表现为反复改自己的实现,方案 B 表现为 Agent 反复大范围返工,本质是同一句话。

四、核心差异:九个维度的拆解

  1. 人的角色定位不同

方案 A 中人是“调用者”,关注具体方法怎么实现,思维粒度是函数与语句;方案 B 中人是“指挥者与验收者”,思维粒度是模块、接口契约、数据流与失败模式。这个转换是很多工程师真正不适的来源:它要求你放弃对实现细节的即时掌控感,把精力投向更难被替代的抽象与判断。

  1. 对代码的理解深度要求不同

方案 A 要求工程师对自己提交的每一行负责;方案 B 允许工程师不逐行掌握,但要求他掌握“契约层”——输入输出、不变量、错误语义、性能特征、依赖边界。注意这不是降低要求,而是把要求从“记住实现”换成“能设计验证手段”。如果一位工程师既不想读实现、又没有能力设计验证(测试、契约检查、灰度观测),那么方案 B 对他而言是风险放大而非效率提升。

  1. 上下文组织方式不同

方案 A 的上下文基本是局部的:当前文件、选中的片段、粘贴进去的报错。方案 B 需要“上下文工程”:项目级的规则说明文件、任务拆解文档、相关模块清单、接口定义、既有测试。上下文不是越多越好,而是需要结构化——把长期稳定的约定放全局,把当前任务相关信息精准投放,避免无关内容稀释注意力。谁能把项目约定写成 Agent 可读的形式,谁就能显著拉开方案 B 的收益。

  1. 交付粒度与迭代节奏不同

方案 A 的交付粒度小、反馈快、返工成本低,适合“边想边写”;方案 B 倾向于一次性交付一个较大的改动面,反馈周期更长,但一旦跑通,单个大块的完成速度优势明显。前者是持续微调,后者是批量交付,这直接决定了它们各自适合的任务规模。

  1. 失败模式不同(这是最关键的差异)
维度 方案 A 的典型失败 方案 B 的典型失败
出错表现 语法/类型错误、API 记错、逻辑写偏,通常编译或单测立刻暴露 代码能编译、能跑通示例,但语义错误、边界遗漏、隐含需求缺失
影响范围 局部,改动可见可回滚 跨多个文件,可能顺带重写无关模块、调整依赖与配置
发现时机 即时 延后,往往到联调或验收阶段
定位难度 低,错误就在刚写的那几行 高,需要在大 diff 中反查“哪一处是模型自作主张”
越权风险 低 存在:执行命令、修改配置、安装依赖、外发请求需人工确认

结论:方案 A 的错误是“显眼的”,方案 B 的错误是“安静的”。安静的错误更贵,所以方案 B 必须配套更强的验证体系,否则效率提升会被返工的隐性成本吃掉。

  1. 验证成本结构不同

方案 A 的验证主要发生在写代码时(靠人);方案 B 的验证必须前置到“可自动执行的资产”上:单元测试、集成测试、静态检查、类型约束、契约测试、CI 流水线。测试覆盖率低的仓库使用方案 B,收益会大打折扣,因为人和 Agent 都失去了唯一的客观裁判。这条因果关系是选型中最实用的一条:测试与 CI 的成熟度,基本决定了你能不能承接方案 B。

  1. 可观测性与调试路径不同

方案 A 的调试是“看代码、打日志、复现”;方案 B 需要在此基础上增加一层“过程可观测性”——Agent 每一步读了什么、执行了什么命令、改了什么文件、依据是什么。缺少这层记录时,一次错误的自动改动可能很难追溯。实践中通常的做法是让 Agent 把计划、变更清单与执行日志显式输出,便于人做阶段性检查点(checkpoint)审阅。

  1. 安全与合规风险面不同

方案 A 的风险主要是代码与上下文外泄(把内部实现粘贴到外部服务),以及生成代码的依赖来源不明。方案 B 在此之上叠加了执行权限风险:Agent 可以读写文件、运行命令、访问网络,这意味着它需要被放在权限受限的环境里,凭据与密钥必须隔离,敏感仓库需要评估是否允许外部模型处理。两种模式都需要注意生成代码引入的第三方依赖的许可证与来源可信性。

  1. 团队能力门槛与协作影响不同

方案 A 对工具链改造要求低,几乎不需要流程变更,个人即可采用;方案 B 影响面是团队级的:代码评审规则、提交颗粒度、测试门禁、权限模型、规则说明文件的维护责任都要随之调整。也就是说,方案 B 不是“换一个更聪明的补全工具”,而是一次研发流程的适应性改造。

五、关键差异对比表

维度 方案 A:人工主导 + 补全辅助 方案 B:Agent 自主编程
技术架构 人 + 模型,无独立执行层 人 + 模型 + 工具执行层(文件读写、命令执行、检索、反馈循环)
人的职责重心 实现细节与语句级决策 需求拆解、架构与契约、上下文治理、验收
代码理解要求 逐行掌握 掌握契约与验证手段,允许不逐行掌握
上下文组织 局部、即时 结构化、项目级,需长期维护
交付粒度 小、连续 大、批量
反馈周期 短 较长
主要失败模式 显性错误,易被编译/测试捕获 隐性语义错误、范围蔓延、越权操作
对测试与 CI 的依赖 中等 高(是收益成立的前提)
安全关注点 代码与上下文外泄、依赖可信性 上述 + 执行权限、凭据隔离、变更范围控制
上手成本 低 中(需建立规则文件、验证体系、审阅习惯)
收益来源 输入与检索加速 重复劳动消解 + 跨文件改动吞吐提升
典型适用 局部改动、强上下文依赖逻辑、算法核心、涉密或离线环境 新项目脚手架、跨文件改造、批量重构、测试与文档补齐、脚本与运维工具、迁移初筛
不适用 大规模重复劳动、成块的新增功能 架构决策、涉密数据、缺少测试的脆弱核心、不可回滚的生产直改

六、示意性示例:任务描述与验收的通用结构

方案 A 更接近“给出意图与约束,自己完成实现”:

  1. # 通用伪代码:方案 A 的交互形态
  2. 上下文:当前文件 + 目标函数的签名与调用方
  3. 指令:实现一个函数,输入为一批事件,按时间窗口聚合,窗口内乱序容忍 N 秒。
  4. 约束:不引入新依赖;保持原有异常处理风格;返回结果需可排序。
  5. 人的职责:自己写主体控制流,遇到不确定的语法或库用法时向模型提问。

方案 B 更接近“任务卡 + 验收条件”,关键是把不可见的隐含要求显式写成可自动检查的项:

  1. # 通用伪代码:方案 B 的任务卡模板
  2. 任务目标:为「事件聚合模块」新增时间窗口聚合能力。
  3. 涉及范围(允许修改):src/aggregation/*,tests/aggregation/*
  4. 禁止修改:配置文件、公共工具库、其他模块接口
  5. 接口契约:输入事件列表 + 窗口参数;输出按窗口分组的聚合结果;空输入返回空集合
  6. 不变量:乱序容忍 N 秒内不产生跨窗口重复计数
  7. 验收条件(必须全部通过):
  8. 1. 编译通过且无新增静态检查告警
  9. 2. 新增单元测试覆盖:空输入、单窗口、跨窗口、乱序边界、N 秒临界点
  10. 3. 既有测试全部通过,无修改既有测试断言
  11. 4. 输出变更清单与执行日志,供人工审阅
  12. 停止条件:若需要修改「禁止修改」范围内的文件,暂停并提问,不得自行扩大范围

这份模板的价值在于:它把方案 B 的主要失败模式(范围蔓延、隐含需求缺失、语义错误无裁判)直接转化为可执行的检查项。换句话说,方案 B 的工程质量,很大程度上取决于这张任务卡写得多严谨。

七、典型场景选择

更适合方案 A 的场景

  • 单个函数或局部逻辑的调整,改动范围小、上下文关系清晰;
  • 依赖大量团队内部隐性知识的实现(历史兼容、业务特例、线上事故教训);
  • 核心算法、精度敏感或性能敏感代码,需要逐行掌控;
  • 涉密代码、隔离内网、不能外发上下文的环境;
  • 生产环境的紧急修复,要求改动最小化、可精确回滚。

更适合方案 B 的场景

  • 新项目的脚手架搭建、目录结构与基础工程配置;
  • 跨多个文件的同类改动,例如接口字段重命名、批量替换旧调用方式、统一异常处理风格;
  • 补齐测试与文档,这类工作量大、模式固定、验证客观;
  • 内部脚本、数据清洗、运维工具、一次性迁移脚本;
  • 遗留系统的初步梳理与迁移方案草稿(结论仍需人复核);
  • 明确边界内的重复劳动,这类任务正是“把苦力活接走”的收益来源。

实践中更常见的形态是混合:日常开发主线保留方案 A 的掌控感,把边界清晰、验证客观的成块任务交给方案 B,并按任务风险分级决定人工审阅的深度。

八、选型建议(条件化)

  1. 先看验证体系,而不是先看模型能力。团队若已有较完整的单元测试与 CI 门禁,可优先考虑扩大方案 B 的使用面;若测试覆盖薄弱,建议先补齐关键路径测试,再逐步引入 Agent 处理非核心模块。
  2. 按任务边界清晰度分配模式。能把“目标 + 范围 + 契约 + 验收条件”写清楚的任务,适合方案 B;写不清楚的任务,说明需求本身还没想清楚,此时方案 A 的低返工成本更划算。
  3. 按代码资产的敏感度分级。核心业务逻辑、涉密模块可保留在受控环境内,由方案 A 主导;非敏感的通用模块、工具代码可更积极采用方案 B。
  4. 按团队运维与评审能力决定推进速度。方案 B 需要有人负责维护规则说明文件、审核变更清单、把关权限模型;缺少这个角色时,激进推进容易积累隐性债务。
  5. 不要把架构决策交给任何模式。技术选型、模块边界、数据模型、失败降级策略,这些应由人基于业务约束做判断,模型只适合提供候选方案与风险提示。
  6. 若倾向使用托管化的 AI 编程能力,可从通用类目维度评估:代码生成与补全质量、对仓库级上下文的支持程度、权限与数据隔离机制、日志与审计能力、与既有 CI 流水线的集成方式。国内团队也可将百度智能云等厂商提供的 AI 编程助手类通用能力纳入评估范围,重点比较接入方式与合规要求是否匹配自身环境,而非仅看生成效果。

九、迁移与使用注意事项

从方案 A 迁移到方案 B,不是打开一个开关,而是 Several 项配套工作,建议按以下清单推进:

关注项 具体风险 建议做法
仓库规范 缺少约定导致 Agent 每次自由发挥,风格漂移 维护项目级规则说明文件:目录职责、命名、日志、错误处理、禁止事项
测试与门禁 无客观裁判,错误只能在验收阶段暴露 先补关键路径测试,把编译、静态检查、测试设为强制门禁
变更颗粒度 一次性大 diff 难以审阅,问题定位困难 拆分任务卡,小步提交,要求 Agent 输出变更清单与理由
权限模型 Agent 越权改配置、装依赖、发起外发请求 最小权限、目录白名单、禁止修改清单、命令执行需确认
凭据与数据 密钥泄露、敏感数据外发 密钥不进入上下文与仓库,使用环境隔离与代理凭据
依赖引入 幻觉出不存在的包,或引入来源不明的依赖 依赖需人工确认来源、许可证与活跃度,不允许自动安装后直接合入
可回滚性 错误改动污染主干 在独立分支工作,保留可回滚的提交序列与检查点
可观测性 无法追溯 Agent 的决策依据 保留执行日志与计划记录,纳入审计
上下文治理 上下文无限膨胀,信噪比下降 分层管理:全局约定 / 模块文档 / 当前任务,定期清理
责任边界 “AI 写的”成为免责借口 明确代码提交即责任人签署,评审标准不因产出方式而降低
团队学习曲线 期望与真实收益不匹配导致反弹 先在低敏感模块试点,用返工率与交付周期做前后对比

需要额外强调两条:第一,幻觉不会消失,它只会在“验证不足”的地方被放大,因此任何引入 Agent 的流程,验证环节都不能省略;第二,如果一位工程师对某个模块既无法理解也无法验证,那么把该模块交给 Agent 是风险累积,而不是效率提升。

十、总结

回到最初的分野:方案 A 与方案 B 的差别,不在模型强弱,而在于人的职责重心迁移到了哪一层。方案 A 让人保持在实现层,好处是掌控感与低返工成本,代价是重复劳动无法消解;方案 B 让人上移到契约层与验证层,好处是成块工作的吞吐提升、人被从键盘苦力中解放出来去处理架构问题,代价是隐性错误更难发现、对测试体系与权限治理的要求显著更高。

所以“全面拥抱”与“绝不放手”都不是好的决策表述。更可操作的原则是:任务边界能写清、验证手段能自动化的部分,优先交给 Agent;涉及架构判断、隐性知识、敏感资产与不可回滚操作的部分,保留人工主导。谁先把项目的约定写成机器可读的形式、把验收条件写成自动可执行的检查,谁就先拿到了下一阶段开发的入场券。

发表评论

活动