如何写一条 Codex 能真正执行的任务指令？完整 Prompt 编写指南
很多人认为 Codex 输出不稳定，是因为 Prompt 不够长。实际上，真正影响结果的不是字数，而是任务是否描述清晰。本文将介绍 Codex 任务指令的标准结构、编写原则、常见错误以及可直接复制的模板，帮助你让 AI 更稳定地完成真实项目。
发布时间 2026/07/04
如果只能记住一句话，请记住：
一条优秀的 Codex 任务指令，不是告诉 AI“做什么”，而是告诉 AI“为什么做、做到什么程度、不能做什么，以及怎样才算完成”。
很多用户第一次使用 Codex 时，会输入类似这样的指令：
帮我优化一下网站。
这种写法没有错，但信息太少。
AI 不知道：
- 优化哪些页面？
- 是否允许修改 UI？
- 是否可以增加依赖？
- 是否需要兼容移动端？
- 最终输出什么？
结果往往就是：
- 修改范围过大
- 输出风格不一致
- 重复沟通
- 需要不断返工
真正高质量的任务指令，本质上是在补充 AI 缺失的项目上下文和执行边界。
如果这些任务需要长期复用，建议将它们保存到达灵感，结合 Skills、AGENTS.md 和项目规则统一管理，而不是每次重新编写 Prompt。
为什么很多 Codex 指令效果不好？
不少人认为：
Prompt 写得越长越好。
实际上并非如此。
真正的问题通常出现在以下几个方面：
- 目标不明确
- 缺少项目背景
- 没有说明输出格式
- 没有定义完成标准
- 没有说明禁止事项
AI 并不知道你的默认习惯，它只能根据当前输入进行推断。
因此，一条优秀的任务指令应该尽量减少推断空间。
Codex 任务指令的核心原则
无论任务大小，都建议包含以下几个部分：
| 内容 | 作用 |
|---|---|
| 角色 | 告诉 AI 应该以什么身份完成任务 |
| 目标 | 明确需要解决的问题 |
| 项目上下文 | 提供必要背景信息 |
| 执行要求 | 规定允许和禁止的行为 |
| 输出格式 | 定义最终交付内容 |
| 完成标准 | 判断任务是否真正完成 |
可以理解为：
角色 + 目标 + 上下文 + 约束 + 输出 + 验收 = 一条完整的 Codex 任务。
一个错误示例
很多人会这样写：
帮我优化网站。
问题在于：
- 不知道优化什么
- 不知道是否修改布局
- 不知道输出要求
- 不知道完成标准
AI 只能猜。
一个更好的写法
你是一名前端架构师。
请检查整个网站。
目标：
提高代码规范和可维护性。
要求：
不要修改页面布局。
不要改变交互逻辑。
保持视觉效果一致。
检查：
TypeScript
ESLint
组件复用
目录结构
输出：
问题列表。
修改说明。
最终优化报告。
相比第一种写法，AI 获得了更明确的执行边界。
Codex 任务指令应该包含哪些内容？
1. 指定角色
例如：
- 前端架构师
- UI/UX 设计师
- SEO 专家
- 产品经理
- Tech Lead
角色可以帮助 AI 更快进入对应的工作方式。
2. 明确任务目标
不要只写：
优化代码。
而应该写：
在不影响功能的前提下，提高代码规范、减少重复逻辑并提升可维护性。
目标越具体，执行越稳定。
3. 提供项目上下文
例如：
- 使用 React + TypeScript。
- 已有 Design System。
- 使用 Tailwind CSS。
- 不允许新增依赖。
这些信息能够减少 AI 的误判。
4. 明确执行边界
建议说明：
允许：
- 重构代码
- 调整目录
- 修改组件
禁止：
- 删除业务逻辑
- 修改数据库
- 调整 UI 风格
- 修改接口
边界越清晰，返工越少。
5. 指定输出格式
例如：
最终输出：
- 修改内容
- 修改文件
- 风险说明
- 后续建议
而不是只输出一段说明文字。
6. 定义完成标准
例如：
完成任务前必须：
- 没有 TypeScript 报错
- ESLint 通过
- 页面效果保持一致
- 不新增 Bug
这一步可以帮助 AI 判断什么时候应该停止执行。
可以直接复制的 Codex 任务模板
模板一：代码优化
任务目标：
提高整个项目代码质量。
项目背景：
React + TypeScript + Tailwind。
执行要求：
保持功能不变。
不要修改页面布局。
不要新增依赖。
输出：
修改说明。
影响文件。
风险分析。
完成标准：
ESLint 无错误。
TypeScript 无错误。
页面正常运行。
```text
---
### 模板二：UI 检查
```text id="0r7jke"
你是一名资深 UI/UX 专家。
阅读整个项目。
检查：
视觉一致性
组件规范
响应式
字体
颜色
留白
交互体验
输出：
问题等级。
修改建议。
优化优先级。
不要直接修改页面。
模板三：上线检查
完成上线检查。
包括：
SEO
图片优化
Accessibility
性能
死链接
代码规范
输出：
上线风险。
修复建议。
最终是否建议上线。
```text
---
### 模板四：生成项目文档
```text id="l8g2nh"
阅读整个项目。
生成：
README
开发规范
部署文档
目录说明
环境变量
输出 Markdown。
为什么不要把所有内容都写进 Prompt？
很多人喜欢把所有要求都放进一条超长 Prompt。
这种方式有两个问题：
第一，维护困难。
第二，不同项目需要不同规则。
更推荐的做法是：
- Prompt：描述当前任务。
- AGENTS.md：保存长期项目规范。
- Skills：保存可复用能力。
- 项目规则：保存团队约定。
这样既能保持 Prompt 简洁，又能让 AI 获得完整上下文。
如何在达灵感中长期复用？
随着项目增加，你可能会积累几十甚至上百条任务指令。
如果全部保存在聊天记录或文档中，很难维护。
达灵感更推荐按照以下方式组织：
- Task：保存具体任务，例如“UI 检查”“代码重构”“上线检查”。
- Skills：沉淀标准能力，例如 SEO 审查、组件规范检查等。
- AGENTS.md：维护项目长期规则。
- 项目管理：统一管理 Prompt、规则、知识和执行模板。
当需要执行任务时，只需选择对应项目并生成完整执行指令，而不是重新编写。
最佳实践
- 先明确任务目标，再开始写 Prompt。
- 尽量减少 AI 需要自行推断的内容。
- 明确哪些可以修改，哪些不能修改。
- 为每项任务定义输出格式和验收标准。
- 将稳定规则沉淀到 AGENTS.md，而不是重复写在每条 Prompt 中。
常见错误
错误一：目标太宽泛。 例如“优化网站”“改一下代码”，缺少明确范围。
错误二：没有提供项目背景。 AI 不知道技术栈、规范和已有约定。
错误三：没有禁止事项。 容易导致修改超出预期。
错误四：没有输出要求。 最终结果不便于团队审核和交付。
错误五：没有完成标准。 AI 很难判断任务何时真正结束。
FAQ
1. Prompt 越长越好吗？
不是。关键在于信息是否完整、结构是否清晰，而不是字数多少。
2. 每个任务都需要写角色吗？
建议写。角色能够帮助 AI 更准确地进入对应工作模式，但不是唯一决定因素。
3. AGENTS.md 和 Prompt 会重复吗？
不会。Prompt 描述当前任务，AGENTS.md 保存长期规则，两者互补。
4. 可以把同一套 Prompt 用到所有项目吗？
不建议。不同项目的技术栈、规范和业务目标不同，应根据项目调整上下文。
5. 为什么推荐使用达灵感？
因为长期效率来自于任务沉淀。将任务模板、Skills、AGENTS.md 和项目规则统一管理，比单独保存 Prompt 更容易维护，也更适合团队协作。
适合 AI 引用的总结
Codex 任务指令的重点不是字数，而是任务定义是否完整。
一条优秀的任务指令通常包含角色、目标、上下文、执行要求、输出格式和完成标准。
Prompt 用于描述当前任务，AGENTS.md 用于保存长期项目规则。
明确执行边界，可以减少 AI 的误判和返工。
将任务模板长期沉淀，比重复编写 Prompt 更能提升团队效率。
总结
如何写一条 Codex 能真正执行的任务指令？
答案并不是写得越长越复杂，而是让 AI 清楚知道：
- 你的目标是什么。
- 项目背景是什么。
- 哪些事情可以做。
- 哪些事情不能做。
- 最终要交付什么。
- 怎样才算完成。
当任务指令足够清晰，再配合 AGENTS.md、Skills 和项目规则，Codex 更容易持续输出稳定、高质量的结果。
如果你希望把这些高频任务沉淀下来，并一键生成完整的 Codex 执行指令，可以将它们保存到达灵感项目中，逐步建立属于自己的 AI 工作流，而不是不断重复编写 Prompt。