AI编程沟通方法+标准话术模板&实例
和AI写代码,核心不是丢一句“帮我写个XX”,而是把需求、约束、环境、输出格式、边界条件说清楚。没有官方强制标准话术,但有一套通用结构化提问范式,可以大幅减少AI输出错误代码、理解偏差、来回返工。
通用万能结构(记这个)
- 角色设定:你希望AI扮演什么工程师
- 任务目标:要做什么功能,核心业务
- 技术约束:语言、框架、版本、依赖、禁止用什么
- 输入输出/业务规则:数据格式、逻辑、边界情况
- 代码要求:注释、是否简洁、是否可直接运行、要不要测试用例
- 附加要求:解释、注意事项、风险点
一、反面例子(很差的提问,尽量不要这样)
❌帮我写个登录系统
❌写个爬虫
❌优化这段代码
问题:信息太少,AI自由发挥,技术栈、复杂度、安全、数据库全部猜,出来的代码大概率不能直接用。
二、正向模板 + 真实示例
模板1:从零开发新功能(完整范式)
话术模板:
请你扮演一名资深【XX语言/框架】后端/前端工程师。
任务:实现【功能描述】。
技术约束:使用【技术栈、版本】,不要使用xxx库;运行环境xxx。
业务规则:
- 规则1
- 规则2,需要处理异常情况xxx
代码要求:
- 代码要完整可直接运行,增加必要中文注释
- 包含简单测试示例
- 不要省略关键逻辑
输出:先简单说明设计思路,再给出完整代码,最后列出使用注意事项。
✅示例1:Python实现简单文件批量重命名工具
请你扮演一名资深Python工程师。
任务:写一个批量重命名本地文件夹图片的脚本。
技术约束:使用标准库,不要引入第三方pip包;兼容Windows。
业务规则:
- 读取指定目录下jpg、png图片
- 重命名格式:img_001.jpg、img_002.jpg,序号自动递增
- 需要跳过子文件夹,只处理当前目录
- 如果目标文件名已存在,要跳过避免覆盖
代码要求:
- 完整可运行,加中文注释
- 写调用示例
输出:先讲实现思路,输出完整代码,最后说明使用注意点。
模板2:基于已有代码,修改/调试BUG
话术模板:
下面是我的代码【粘贴代码】
问题描述:我想要实现XX效果,现在出现的现象是xxx。报错信息:【复制报错】
运行环境:语言版本xxx,依赖版本xxx
我的期望:
- 修复bug,保持原有整体逻辑不变,不要大规模重写
- 指出出错的根本原因
- 给出修改后的完整代码,标注改动的地方
✅示例2:调试Python列表处理代码
下面是我的代码
data = [1,2,3,4,5]
for i in data:
if i %2 ==0:
data.remove(i)
print(data)
问题描述:我想删除列表中所有偶数,但是运行结果不对。没有抛出报错。
运行环境:Python3.11
我的期望:
- 修复bug,尽量不要完全推翻原有思路
- 告诉我为什么原来代码出错
- 返回修改完成代码
模板3:代码优化、重构、代码评审
话术模板:
请作为代码评审工程师,评审下面这段代码。
【粘贴代码】
背景:这段代码用于【用途】。
评审维度:性能、可读性、异常处理、潜在bug、代码规范。
输出要求:
- 逐条列出现存问题
- 给出优化后的完整代码
- 简单解释每一处优化点
✅示例:JS工具函数评审
请作为前端工程师评审下面js函数。
function calcTotal(arr){
let sum=0;
for(var i=0;i<arr.length;i++){
sum = sum + arr[i];
}
return sum
}
背景:用来计算数组数字总和。
评审维度:边界情况(空数组、数组包含非数字)、代码规范、健壮性。
输出:列出问题,给出优化代码,说明改动。
模板4:解释代码 / 学习看懂一段代码
话术模板:
帮我逐段解释下面代码。
【粘贴代码】
我的基础:【新手/了解基础】
输出:分块讲解每一部分作用,重点难点单独说明,不要跳步骤。
模板5:需求模糊,让AI做方案选型,不直接写代码
有时候你还不知道怎么实现,先问方案,不要直接让写代码。
我需要实现【需求】,可选技术栈限定:A、B。
请对比不同实现方案,分别说明优缺点、适用场景、风险,最后给出你的推荐,暂时不要写代码。
✅示例:
我要做一个本地小工具,实现简单GUI界面读取csv文件。可选:Python tkinter / PyQt。
请对比两个方案,优缺点,适合我的场景,给出推荐,暂时不要写代码。
三、高阶实用技巧(非常关键)
1. 迭代开发:不要一次性想要完整大项目
大系统不要说“帮我写完整商城系统”。
拆成小任务:
- 第一步:先设计数据库表结构
- 第二步:写用户注册接口
- 第三步:写登录鉴权>
每次只让AI完成一小块,拿到结果再继续下一部分,可控性强。
2. 约束AI不要做的事
明确禁止项,减少踩坑:
- “不要使用废弃API”
- “不要写硬编码密钥,所有配置抽离成变量”
- “不要用过于复杂的第三方库,优先标准库”
- “需要考虑输入参数校验,防止异常输入”
3. AI代码出来之后,追加提问话术
拿到代码不要直接复制跑,可以追加一句:
帮我梳理下这段代码潜在风险点,哪些地方生产环境不能直接使用?
4. AI代码报错后,不要只说“报错了”
把完整报错堆栈、你的输入、运行环境一起粘贴。
运行你给的代码报错:Traceback xxxxx
我的环境:python3.10,系统windows11,我调用时传入参数xxx。帮我定位和修复。
四、速查极简提问卡片,可以直接复制改内容
- 新建功能
扮演【工程师】,实现【功能】
技术栈:xxx,禁止xxx库
业务规则:
1.
2.
要求:完整可运行,中文注释,附带测试。先思路,再代码,最后注意事项。
- 修bug
代码:
【粘贴】
现象:xxx,报错:xxx
环境:xxx
要求:找出根因,最小改动修复,输出完整代码标出修改位置。
- 代码评审优化
评审以下代码:
【粘贴】
用途:xxx
检查:bug、异常处理、性能、规范。列出问题,给出优化代码加说明。
五、常见踩坑提醒
- AI经常省略异常处理、参数校验,一定要在prompt明确要求处理边界;
- AI会默认使用最新库,如果你是旧版本环境,必须写明版本号;
- 涉及密钥、密码、数据库连接,AI很容易写死在代码,prompt里明确要求配置抽离;
- 复杂项目切忌一次性生成全部代码,分模块迭代是最高效方式。
如果你需要,我可以拿一个你真实的开发需求,现场演示一遍完整提问和AI输出全过程。