AI编程提示词工程：三层框架让你的Codex输出质量翻倍、Token省75%

同样接的GPT-5.5，同样用的Codex，有的人10分钟搞定一个功能，有的人30分钟还在来回拉扯。差别在哪？不是工具、不是模型、不是网速——是指令。给AI的指令精确到哪个文件、哪个函数、哪种异常处理方式，输出质量天差地别。这篇文章不讲玄学，只讲实测有效的AI编程提示词框架，以及背后的Token消耗逻辑。

一、AI编程的提示词为什么和ChatGPT不一样？

很多人把和ChatGPT聊天的习惯直接搬到了Codex和Claude Code上，结果发现效率不升反降。因为两者的Token消耗模式和上下文管理方式完全不同：

AI编程的提示词本质上是用最少的Token描述清楚「改哪里、怎么改、边界是什么」。一个好的提示词可以省下50%以上的Token消耗——因为模型不需要反复试错来猜你的意图。

二、三层提示词框架

实测效果最好的AI编程提示词结构：

【层级一：目标层】你想达成什么
「为 src/api/users.ts 的列表接口添加分页功能」

【层级二：约束层】怎么改、有什么限制
「使用已有的 PaginationParams 类型，每页默认20条，支持 page 和 pageSize 查询参数，前端已适配」

【层级三：边界层】什么不能动
「不要修改数据库层的查询逻辑，不要改动其他接口，不要引入新的依赖包」

三层信息的完整示例：

在 src/api/users.ts 的 GET /users 接口中添加分页功能。
使用已有的 PaginationParams 类型（在 src/types/common.ts 中），
每页默认20条，支持 page 和 pageSize 查询参数。
不要修改 src/db/ 下的数据库查询逻辑。
不要改动其他接口。
不要引入新的 npm 依赖。
分页参数校验使用已有的 validatePagination 工具函数。

模糊指令：「帮我给用户列表加分页」— 平均 4-6 轮对话才能得到正确结果，Token消耗约 80,000+。

精确指令：「在 src/api/users.ts 的 GET /users 添加分页，用已有 PaginationParams，默认20条每页」— 通常 1-2 轮完成，Token消耗约 20,000。

同样的功能，精确指令节省了75%的Token。而API费用是按Token计费的——GPT-5.5每百万Token ¥0.83，一次精确指令省下的60,000 Token相当于 ¥0.05。看起来不多，但一天几十次交互，一个月就是几十块的差距。

三、不同任务的提示词模板

3.1 新增功能

在 [文件路径] 中新增 [功能描述]。
输入：[入参类型和来源]
输出：[返回值格式]
使用已有的：[相关工具函数/类型/组件]
不要：[限制条件]
测试用例：[关键测试场景]

3.2 Bug修复

在 [文件路径] 的 [函数名/行号] 有一个Bug：
现象：[具体什么表现]
预期：[应该是怎样的]
线索：[已知的调试信息、日志、报错]
不要改动：[相关但不需要改的部分]

3.3 代码审查

审查 [文件路径] 的代码：
- 安全性：SQL注入、XSS、权限校验、敏感信息泄露
- 性能：N+1查询、无索引查询、不必要的循环、未释放的资源
- 可维护性：命名、注释、函数长度、职责单一
按严重程度排序，给出具体修改代码

3.4 重构

重构 [文件路径/模块名]：
目标：[拆分/合并/抽象/简化]
保持：[外部接口不变、现有测试通过]
移除：[旧代码/废弃API/冗余逻辑]
新结构：[期望的目录或文件组织方式]

四、提示词里的「元信息」很重要

给AI编程工具的提示词比给ChatGPT的多了一层——你需要提供足够的项目元信息，让AI能理解代码上下文。最有效的做法是在项目根目录维护一个 .context.md 文件：

# 项目上下文
- 技术栈：TypeScript + Express + Prisma + PostgreSQL
- 目录结构：src/api（路由）、src/services（业务）、src/db（数据层）
- 通用类型：src/types/common.ts
- 工具函数：src/utils/
- 测试框架：Jest，文件命名 *.test.ts
- 代码规范：函数不超过50行，每个文件只export一个主函数
- 数据库：所有查询走 Prisma，不写原始SQL

把这个文件放在项目根目录，每次开新对话时引用一下：

参考 .context.md 的项目规范，然后在 src/api/orders.ts 中……

这样不用每次对话都把项目信息重新讲一遍——.context.md里的一次性Token投入，换回的是每一次对话的高质量输出。

五、Token消耗的「隐形成本」：被你忽视的上下文膨胀

很多人只看到每次请求的Token消耗，但忽略了一个更大的问题：对话历史的累积Token。

Codex和Claude Code都是会话式的，每一轮对话的历史都会占用下一个请求的Token预算。假设你每一个Prompt是3,000 Token、AI回复5,000 Token，那么第10轮对话时，历史上下文已经膨胀到了80,000 Token——而你的API调用是按请求里所有Token计费的。

解决方法：

1. 长任务定期 /clear：一个功能完成后清空历史，开新对话做下一个功能；
2. 设置自动压缩：在Codex配置中设上下文压缩阈值：

# ~/.codex/config.toml
model_auto_compact_token_limit = 900000

省下来的Token就是省下来的钱。而这些钱和你的API接入平台直接相关——选择Token单价低的聚合平台，同样的用量，费用可以差几十倍。

获取GPT-5.5和Claude 4.7的API接入凭证，可以在 api.bblabu.cn 注册账号，进入「令牌管理」创建Key。注册后即可获得两个模型的调用权限，按实际消耗计费，无最低消费。

六、实测：提示词优化前后对比

我做了个实验：同一个任务「实现用户注册API」，用模糊指令和精确指令分别让Codex执行，对比结果：

模糊指令的结果是：代码能跑，但缺少校验和异常处理，需要人工补充。精确指令的结果是：直接可以合并，零改动。两者的Token费用差了整整4倍。

提示词工程不是什么玄学，是用有限的Token换取最大的代码产出。掌握这三个层级和四套模板，日常的API调用费用至少省掉一半——而且代码质量更高。

七、总结

AI编程提示词的核心原则就三条：

1. 说清楚「改哪里」——文件名、函数名、行号，越精确越好；
2. 说清楚「怎么改」——数据类型、接口格式、命名规范、异常处理；
3. 说清楚「别动什么」——保护不该动的代码，比告诉AI该做什么同样重要。

好的提示词不是「更聪明」，而是「更精确」。精确到什么程度？精确到AI不需要猜你的意图。AI猜一次就用掉几千Token，猜三次就上万——而你的API账单上，每一Token都在计费。

工欲善其事，必先利其器。好的提示词框架 + 低Token单价的API接入，才能让AI编程真正从「偶尔用用」变成「日常标配」。

本文链接：https://www.kkkliao.cn/?id=3937 转载需授权！