Codex Prompt 中“目标 + 约束 + 上下文 + 验证标准 + AGENTS.md”终极组合版

本文聚焦一套更完整的终极方法：不仅教你如何写出一次高质量 Prompt，还进一步说明如何把这些 Prompt 里反复出现的目标、约束、上下文和验证标准，沉淀成项目级 AGENTS.md。这样，Codex 不只是"这一次回答得更好"，而是后续每一次都能更稳定地工作。

1. 文档目标

这份文档解决的是从"会写 Prompt"升级到"会建立长期 AI 协作机制"的问题：

• 怎么把目标、约束、上下文、验证标准写成高质量 Prompt
• 怎么把这些内容进一步沉淀成 AGENTS.md
• 为什么单次高质量输入和长期规则文件应该连起来看
• 怎样让 Codex 既能回答当前任务，又能逐渐贴近项目习惯

读完后，你应该能够：

• 写出更稳的单次任务 Prompt
• 识别哪些内容适合沉淀为长期规则
• 生成一份更贴合项目的 AGENTS.md 草案
• 让团队逐步建立稳定的 Codex 协作方式

2. 为什么这五件事必须连起来看

很多团队现在会做其中一部分，但没有串起来：

• 有的人会写目标
• 有的人会补约束
• 有的人会给一些上下文
• 有的人会加验证要求
• 但很少有人把这些长期沉淀进 AGENTS.md

结果就是：

• 这次问得不错，下次还得重新解释
• 个人会用，团队不会复用
• 规则只存在脑子里，不存在仓库里

所以更好的思路是：

1. 先用高质量 Prompt 解决当下任务
2. 再从这些 Prompt 中提炼稳定规则
3. 再沉淀到 AGENTS.md

3. 五个部分各自解决什么问题

3.1 目标

解决：

• 最终要完成什么
• 当前这一轮先完成什么

3.2 约束

解决：

• 不能改什么
• 必须兼容什么
• 不允许做什么

3.3 上下文

解决：

• 当前项目是什么
• 相关模块和文件在哪里
• 当前问题场景是什么

3.4 验证标准

解决：

• 怎样算完成
• 输出结果如何判断对不对

3.5 AGENTS.md

解决：

• 把反复出现的规则长期固化
• 让 Codex 不用每次都重新被解释

4. 这套终极方法的核心思想

可以概括成一句话：

先用"目标 + 约束 + 上下文 + 验证标准"把一次任务说清，再把其中稳定可复用的部分沉淀进 AGENTS.md。

5. 推荐的双层结构

这套方法最适合用"双层结构"理解。

第一层：单次任务 Prompt

用于当前任务执行。

第二层：项目级 AGENTS.md

用于长期规则沉淀。

图示

单次任务 Prompt
目标
约束
上下文
验证标准
提炼稳定规则
生成 / 更新 AGENTS.md

6. 第一层：怎么写高质量单次任务 Prompt

最推荐的结构仍然是这四块：

目标：
当前这一步：
项目背景 / 相关文件 / 当前现象：
约束：
风险提示：
输出要求：
验证标准：

这一步的重点是：

• 让当前任务说清楚
• 让 Codex 不跑偏

7. 第二层：怎么判断哪些内容适合沉淀成 AGENTS.md

不是所有 Prompt 内容都应该进 AGENTS.md。

适合沉淀的内容

• 项目长期不变的模块结构
• 代码分层规则
• 常见高风险区域
• 常见 Git 协作要求
• 长期通用的验证要求
• 团队明确禁止的行为

不适合直接沉淀的内容

• 这一次临时的 bug 现象
• 这一次任务独有的目标
• 只对当前需求成立的局部约束

一句话判断：

重复出现、长期有效的内容，适合进 AGENTS.md。

8. 从 Prompt 到 AGENTS.md 的提炼逻辑

可以按下面方式提炼：

从"目标"里提炼

提炼出：

• 团队常见任务类型
• AI 应承担的工作范围

从"约束"里提炼

提炼出：

• 长期边界
• 高风险禁改项
• 默认优先策略

从"上下文"里提炼

提炼出：

• 项目结构说明
• 模块职责说明
• 常见入口文件和规则文件

从"验证标准"里提炼

提炼出：

• 合并前检查要求
• 修改后默认验证要求

9. 推荐的终极 Prompt 结构

目标
当前这一步
上下文
约束
风险提示
输出要求
验证标准
可沉淀规则识别
AGENTS.md

10. 最推荐的终极组合模板

请帮我处理一个任务，并在最后指出哪些内容适合沉淀进 AGENTS.md。

目标：
[最终要达成什么]

当前这一步：
[当前只先完成什么]

项目背景：
[项目类型 / 技术栈 / 核心模块]

相关文件或模块：
[关键位置]

当前现象：
[问题表现 / 当前状态]

约束：
[不能改什么 / 必须兼容什么 / 不做什么 / 优先怎么做]

风险提示：
[高风险点]

输出要求：
1. [先做什么]
2. [再做什么]
3. [最后做什么]

验证标准：
[怎样算完成]

额外要求：
请在最后补充：
1. 哪些规则适合沉淀进 AGENTS.md
2. 建议怎么表述这些规则

11. Java / Spring Boot 项目实战实例

场景

订单分页接口在带手机号筛选时返回空数据。

推荐终极写法

请帮我处理一个 bug，并在最后指出哪些内容适合沉淀进 AGENTS.md。

目标：
修复订单分页接口手机号筛选失效问题。

当前这一步：
先判断根因，不直接改代码。

项目背景：
这是一个 Spring Boot + MyBatis 项目。

相关文件：
1. OrderController
2. OrderServiceImpl
3. OrderMapper
4. OrderMapper.xml

当前现象：
带手机号筛选时返回空数据，不带手机号时正常。

约束：
1. 不修改接口路径
2. 不改变入参结构
3. 不做无关重构
4. 不影响其他筛选条件

风险提示：
涉及 SQL 动态条件和分页逻辑。

输出要求：
1. 先判断更可能是参数、Java 逻辑还是 SQL 条件问题
2. 再给最小修复建议
3. 最后给验证步骤

验证标准：
1. 手机号筛选恢复正常
2. 其他筛选条件不受影响
3. SQL 条件输出符合预期

额外要求：
请最后指出哪些规则适合沉淀进 AGENTS.md。

可能沉淀出的规则

• Mapper / XML 改动后要重点验证动态条件和分页逻辑
• 查询类 bug 优先最小修改，不做无关重构
• 接口筛选修复后必须回归其他筛选条件

12. 功能开发实战实例

场景

给会员资料管理新增 customerLevel 字段。

推荐终极写法

请帮我处理一个功能开发任务，并在最后指出哪些内容适合沉淀进 AGENTS.md。

目标：
给会员资料管理新增 customerLevel 字段，并最终支持新增、编辑、分页筛选和列表展示。

当前这一步：
先只分析影响范围并列出应修改模块，不直接改代码。

项目背景：
这是一个 Java / Spring Boot + MyBatis 项目。

相关模块：
1. MemberController
2. MemberServiceImpl
3. MemberMapper / MemberMapper.xml
4. ReqVO / RespVO / SaveVO
5. 前端列表和表单页面

约束：
1. 优先最小改动
2. 不做无关重构
3. 保持现有接口风格
4. 兼容现有列表和筛选逻辑

风险提示：
涉及前后端联动和查询条件扩展。

输出要求：
1. 输出影响范围
2. 输出建议修改文件
3. 输出风险点
4. 输出建议执行顺序

验证标准：
1. 影响范围识别完整
2. 风险点覆盖主要修改区域
3. 后续执行路径清晰可用

额外要求：
请指出哪些规则应写入 AGENTS.md。

可能沉淀出的规则

• 字段扩展任务优先按对象层、Service 层、SQL 层、前端层拆分
• 前后端联动任务优先最小改动，并补联调清单
• 列表筛选扩展后必须回归旧筛选逻辑

13. 测试回归实战实例

场景

一个需求已开发完成，要补测试和回归。

推荐终极写法

请帮我补充测试回归方案，并在最后指出哪些验证规则适合沉淀进 AGENTS.md。

目标：
为本次 customerLevel 字段扩展补充测试范围和回归清单。

当前这一步：
只输出测试点和验证清单，不修改代码。

项目背景：
Spring Boot + MyBatis，涉及会员列表、编辑表单和分页筛选。

已完成改动：
1. 后端字段流转已完成
2. SQL 筛选已支持
3. 前端展示已完成

约束：
1. 不改代码
2. 覆盖正常、异常、边界和回归场景

风险提示：
查询条件扩展可能影响旧筛选逻辑。

输出要求：
1. 功能测试点
2. 异常测试点
3. 边界测试点
4. 联调清单
5. 回归清单

验证标准：
1. 覆盖核心路径
2. 覆盖主要副作用风险
3. 测试清单可直接执行

额外要求：
请指出哪些验证规则适合写入 AGENTS.md。

14. 一份可直接生成 AGENTS.md 的提炼模板

当你已经跑过多轮高质量 Prompt 后，可以直接这样要求：

请基于我们前面多轮任务中的目标、约束、上下文和验证标准，总结一份适用于本项目的 AGENTS.md。

要求：
1. 提炼长期有效规则，不要写一次性临时现象
2. 包含项目说明、模块规则、修改边界、Git 协作要求、验证要求和禁止事项
3. 内容贴近真实项目，不要空泛

15. 一份可直接复制的 AGENTS.md 结构建议

# AGENTS.md

## 项目说明

## 模块与目录职责

## AI 工作原则

## 默认 Prompt 结构要求

## 修改边界与约束

## 高风险场景规则

## Git 协作规则

## 测试与验证要求

## 禁止事项

16. 标准操作流程

1. 写高质量单次 Prompt
2. 执行任务并观察哪些约束反复出现
3. 提炼长期有效规则
4. 生成 AGENTS.md 草案
5. 团队评审与补充
6. 正式入库并持续更新

17. 常见误区

17.1 误区一：一上来就直接生成 AGENTS.md

问题：

• 没有足够任务上下文支撑，规则容易空泛

17.2 误区二：把一次性需求细节也写进 AGENTS.md

问题：

• 规则会很快失效

17.3 误区三：Prompt 写得很好，但从不沉淀

问题：

• 团队一直重复劳动

17.4 误区四：只沉淀约束，不沉淀验证要求

问题：

• 团队知道怎么做，却不知道怎么验

18. 注意事项

• 先把单次 Prompt 写清楚，再提炼规则
• 只把长期有效、反复出现的内容沉淀进 AGENTS.md
• AGENTS.md 不要写成空泛宣言，要写成可执行规则
• 验证标准非常适合沉淀成项目默认要求
• 团队必须人工评审最终规则文件

19. 高质量提示词模板

19.1 终极组合模板

请帮我处理一个任务，并在最后指出哪些内容适合沉淀进 AGENTS.md。

目标：

当前这一步：

项目背景：

相关文件或模块：

当前现象：

约束：

风险提示：

输出要求：

验证标准：

额外要求：
1. 识别适合沉淀的长期规则
2. 给出 AGENTS.md 表述建议

19.2 AGENTS 提炼模板

请基于我们已经完成的多个任务，总结一份 AGENTS.md。

要求：
1. 只保留长期有效规则
2. 包含修改边界、风险控制、Git 协作和验证要求
3. 内容贴近真实项目

20. 团队落地建议

如果你想把这套终极方法推广到团队里，建议这样做：

1. 先统一高质量 Prompt 结构
2. 记录高频任务中重复出现的约束和验证要求
3. 定期汇总这些规则生成 AGENTS.md
4. 团队评审后正式入库
5. 后续随项目演进持续维护

21. 一句话总结

"目标 + 约束 + 上下文 + 验证标准 + AGENTS.md" 的终极组合版，本质上是在把一次高质量问法，升级成一套长期稳定的项目 AI 协作机制。

22. 快速上手清单

• 先把单次任务 Prompt 四件事写清楚
• 再观察哪些规则反复出现
• 再把这些规则提炼进 AGENTS.md
• 最后让团队评审并长期维护