Codex 提示词工程——写出让 Codex 一次理解对的高效 Prompt

同样是用 Codex，有人一句话就搞定一个模块，有人来回 10 轮还在改需求。 区别在哪里？Prompt 的质量。

这篇文章不讲虚的，直接给你一套可复用的提示词模板和原则。

一、Codex Prompt 的黄金法则

法则一：说清楚"改什么"和"不改什么"

Codex 默认会主动扩大修改范围。如果你不说不改什么，它可能会重组你的整个项目。

❌ "帮我改一下登录接口" ✅ "在 src/auth.py 的 login 函数里加上验证码校验。 不改其他函数，不改路由结构，不改数据库表结构。"

法则二：给范围，不给结论

指定文件范围是省 token 最有效的办法。

❌ "帮我查一下为什么性能慢" ✅ "分析 src/services/user_service.py 和 src/api/user.py 中的数据库查询， 找出 N+1 查询问题。 只改这两个文件。"

法则三：先说"是什么"，再说"怎么做"

Codex 理解上下文的顺序是：先理解整体，再理解局部。

❌ "加一个 filter 参数" ✅ "在 /api/users 的 GET 接口中，加一个 ?status=active 查询参数， 过滤用户列表。"

法则四：一次性给全信息

Codex 执行时，回头补信息浪费你的时间也浪费 token。

❌ 先："帮我修这个 bug" 然后："哦，在 auth.py 里" 再："用 JWT，不是 session" ✅ "修复 src/auth.py 中的 JWT token 过期检测 bug： - 当前行为：过期后返回 401，但没有刷新机制 - 期望行为：过期后自动用 refresh_token 续期