第 6 章
进阶
16 分钟6 / 8提示词工程:让 Codex 稳定发挥
目标、约束、上下文、验收四件套;坏提示对照与可复用模板库。
提示词
模板
质量

模型再强,模糊指令也会产出模糊结果。Codex 对「可执行、可验证、范围清晰」的提示特别友好。

四件套结构
- 目标:一句话说明完成后世界变成什么样
- 范围:可以碰 / 不要碰的路径与模块
- 约束:风格、兼容性、性能、安全红线
- 验收:命令、测试名、截图/行为描述
text·完整模板
【目标】
为 POST /api/checkout 增加幂等键支持,重复请求返回同一订单。
【范围】
可改:src/routes/checkout.ts, src/services/order.ts, 相关测试
不要改:支付网关适配器、前端
【约束】
- 幂等键从 header Idempotency-Key 读取
- 与现有错误码风格一致
- 不引入新依赖
【验收】
- 单测:同一 key 两次请求 orderId 相同
- npm test -- checkout 通过
- 先给计划,我批准后再改代码坏提示 vs 好提示
避免
「这个接口有点慢,优化一下」
推荐
「用日志定位 /api/search 的 N+1;在 repository 层加批量查询;保持 API 响应形状不变;说明前后耗时」
避免
「帮我写个登录」
推荐
「在现有 better-auth 栈上增加邮箱密码登录页;复用 src/lib/auth;移动端可用;不要自建 JWT」
给足上下文,但不要倾倒
- 贴关键报错栈、失败测试名、相关文件路径
- 说明「已尝试过什么」避免它重复死胡同
- 大日志只贴头尾 + 关键帧,完整日志放文件让它自己读
- 产品规则用条目列出,而不是散文
迭代话术
text·纠偏用语
- 停止改其它文件,只处理 src/foo.ts
- 你的假设 X 是错的,以 bar.ts 的实现为准
- 回退上一次对 css 的修改,保留逻辑改动
- 不要新增抽象,用现有 utils/fetchJson
- 先写失败测试,再实现到绿