大数跨境

AI Coding 让 AI 改代码前,先过这 4 道关:说清楚、问明白、控过程、验结果

AI Coding 让 AI 改代码前,先过这 4 道关:说清楚、问明白、控过程、验结果 智能体AI
2026-09-25
2
导读:AI 越强篓子越大:管好代码 Agent 的“四步控局法”(附 5 套现成模板)

工具越强,对“如何交代任务”的要求反而越高——因为一旦理解错误,能造成的破坏也随之变大。

两周前遇到一个典型案例:同一个电力营销系统,同一个修改电费计算的需求,交由两名开发人员使用AI处理。一人半小时搞定,仅核对Diff后直接合并;另一人折腾大半天,AI修改后设计文档未同步、接口规范对不上、测试缺失,甚至牵连修改了十几个不相关文件,回滚困难。

使用的是同一个模型,差别何在?对比对话记录发现,根本不在AI能力,而在于任务交代是否清晰。前者提供了包含文件名、行号、规范出处的具体指令;后者仅表示“帮我看看电费计算这块有没有问题”。

AI Coding发展至今,Agent已能自主搜索代码库、读取多文件、调用工具并连续执行。但工具越强,对任务指令的要求越高。以下是在实践中总结的AI任务交付经验。

一、问题剖析:模糊指令的隐患

以“帮我检查一下电费计算这里有没有问题”为例,这类指令存在诸多漏洞:未指明具体文件与方法、未明确是阶梯电价还是峰谷电价、缺乏判断依据(代码规范或业务规则)、未要求同步文档与测试。

指令模糊时,AI只能靠猜,而“猜出来的结果往往包装得十分逼真”。在企业级系统中,代码只是网络上的一个节点,牵一发而动全身。孤立地修改代码而不顾及业务规则、系统架构与接口,必然导致系统整体不一致。问题的核心不在于AI是否会写代码,而在于开发者是否具备将工程任务讲清楚的能力。

二、核心框架:AI任务交代的四步法

经过实践验证,高效的AI任务交付可归结为四个阶段:说清楚、问明白、控过程、验结果。

AI任务交代四步法

1. 说清楚:给事实锚点,划定清晰边界

最有效的沟通方式是提供事实锚点,而非使用形容词。将“这里好像有点问题”替换为具体的文件路径、行号及对照规范。例如:

power-metering/.../settlement/ElectricityCalcService.java:46-48
调用电费计算服务时,没有拼装《电费计算接口规范 v1.2》要求的输入字段,请检查这个调用链,说明问题原因。

同时,必须明确划定任务边界,说明“做什么”与“不做什么”。范围、对象、任务与边界四层信息一次说清,可有效防止AI自由发挥。

2. 问明白:要求提供依据,鼓励主动提问

面对复杂问题,需将提问方式从“你觉得为什么”转变为“你的判断依据是什么”,并明确要求AI在缺乏明确依据时直接说明,避免基于错误假设生成代码。

此外,对于AI无法从现有文档中推断的历史遗留问题或特殊业务规则,应明确要求其“先向我提问,确认后再继续”,使AI从单纯的“回答机器”转变为真正参与项目的协作者。

3. 控过程:评估影响范围,设置人工确认闸门

在企业研发中,修改一处代码往往牵动十几处关联。因此,复杂任务必须先评估影响范围(如架构文档、接口定义、数据模型等),再决定改动范围。

切忌盲目点击“Apply”直接应用修改。稳妥的流程应遵循“先分析、出方案、人确认、再执行”的原则。对于删除文件、修改公共接口、操作数据库等高风险操作,必须设置前置的人工确认闸门。

4. 验结果:多层级验收,拒绝“自嗨式”完成

不能轻信AI的“已完成”提示。靠谱的验收应包含三层:一是让AI自查遗漏;二是通过编译、单测等工具进行验证;三是最关键的,人工核对Git Diff,确认未篡改授权范围之外的文件,拿事实去核对最终结果。

三、实战演练:完整任务拆解与基建沉淀

1. 完整案例:标准八步改造法

以“电费计算接口新增峰谷电价规则”为例,完整的AI Coding任务应包含以下步骤:

  1. 给上下文:阅读相关规范文档、源代码及测试用例。
  2. 明边界:明确本次仅处理峰谷电价计算,不修改其他规则。
  3. 给范例:提供参考的实现代码结构。
  4. 析依据:要求AI说明当前实现不支持新规则的原因及依据。
  5. 留口子:对不确定的业务规则,要求AI先提问。
  6. 摸影响:分析变更对文档、接口、数据及测试的影响面。
  7. 出方案:输出完整修改计划,暂不修改代码。
  8. 严收口:人工确认后执行,并通过测试与核查确保无遗漏。

2. 基建沉淀:将规则固化为项目基础设施

如果每次都要向AI重复“表名必须下划线”等基础规则,说明这些规范亟需沉淀。利用Cursor、Claude Code等工具的机制(如.cursor/rules/、AGENTS.md等),将架构规则、命名规范、安全边界直接写入代码仓库。让Prompt从一次性对话内容,升级为项目研发基础设施的一部分,使AI优先读取规则再执行任务。

3. 实用模板:5个高复用Prompt模板

掌握以下五个核心模板,即可应对绝大多数开发场景:

  • 排查类:排查[范围]下的[对象],找出[问题],给出位置、依据及建议。先分析,不修改。
  • 理解类:阅读[相关文件],分析[问题]原因。对无法确定的信息不猜测,向我提问。
  • 生成类:基于[源文件]和[规范],生成[目标产物],格式参考[模板]。不确定处先提问。
  • 变更类:根据确认的方案修改[范围],修改前检查关联设计、代码和测试,严禁越权修改。
  • 收口类:核查本次变更涉及的所有文档、代码和测试,检查遗漏与违规,通过检索和Diff验证并列出结果。

四、总结

模型能力越强,能接手的任务越复杂,理解偏差带来的代价也越大。未来真正稀缺的能力,并非编写花哨的Prompt,而是清晰地界定AI的工作边界——定义问题、提供上下文、约束行为、判断方案、控制执行时机并设定验收标准。

在电力等复杂行业中,业务规则与系统架构才是真正的硬骨头。AI能辅助搜索与编码,但“什么能改、什么是对的”,仍需人类拍板。本文总结的四步法,本身也应被封装为标准Skill(如开源项目 coding-task-refiner,可通过GitHub获取),以实现经验的规模化复用。

核心心法:小任务靠说清楚,复杂任务靠控过程,关键任务一定要验结果。

【声明】内容源于网络
0
0
智能体AI
1234
内容 505
粉丝 0
智能体AI 1234
总阅读21.2k
粉丝0
内容505