高质量 AI 编程提示词应同时写明目标、上下文、修改范围、约束和验收。能写出可执行、可复核的提示词，并用 diff 与测试判断任务是否完成本文给出的是可复现流程，所有界面和服务可用性以核验日期的官方文档为准。
开始前：先定义完成标准
适合人群：使用 Cursor、Codex、Copilot 或聊天模型修改代码，但经常遇到越界改动的开发者。
第一步把“修复登录问题”改成可观察症状、复现步骤和期望结果。
- 先保存或提交现有改动，保证可以回退。
- 示例不含真实密钥、客户数据和生产地址。
- 把测试命令和预期结果写在生成代码之前。
按步骤完成任务
1. 目标写成可观察结果
描述用户做了什么、看到了什么、正确结果是什么。错误信息原样引用，并注明运行环境和版本，不要只写“这里有 bug”。
2. 明确允许范围
列出允许修改的文件或模块、不得变化的公共接口、是否允许新增依赖。让工具先读相关文件并给出计划，再开始修改。
3. 把验收前置
在生成代码前写下测试命令、关键输入和预期输出。如果没有自动测试，至少给出可重复的手工步骤和需要观察的日志。
4. 规定失败时的动作
遇到缺文件、无法运行测试或事实不确定时，要求停止并报告缺口，不允许猜测接口。这样能把“看起来合理”与“已经验证”分开。
任务契约提示词示例
目标：修复空购物车结算仍创建订单的问题。
范围：只改 checkout/service.py 与对应测试；不改 API 响应结构。
验收：pytest tests/checkout/test_empty_cart.py -q 通过；空购物车返回 400；数据库无新订单。
失败处理：测试环境缺失时停止并列出所需配置，不猜测结果。
把示例中的路径、字段和命令替换为自己的真实项目值。示例只用于说明方法，不冒充真实项目执行结果。
怎样验证结果
执行后必须查看 diff，并运行提示词中预先写好的测试或检查命令；模型自述“已完成”不算验收。
- 先核对工具实际修改的文件和配置，不依据聊天摘要判断。
- 运行预先约定的最小验证，再检查一个失败或边界输入。
- 记录命令、环境、退出状态和仍未覆盖的风险；验证失败就回到具体差异修正。
失败处理与适用边界
提示词不能替代仓库事实和权限控制；密钥、客户数据与生产凭证不得为了补充上下文直接粘贴给工具。
遇到错误时保留完整报错、工具版本、操作系统和最小复现输入。一次只修改一个变量；无法获得必要权限、依赖或官方信息时停止，不让 AI 猜测成功结果。
官方资料
相关问答
AI 说已经完成，是否可以直接提交？
不可以。至少要查看实际差异并运行约定的验证；涉及权限、依赖或数据的改动还要由对应负责人审查。
无法运行完整测试怎么办？
如实记录缺少的环境或权限，先运行可用的最小检查，并把状态保留为未完全验证，不把推测写成已通过。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/31143.html
