tutorial
如何把一个 Codex 任务描述清楚
一份适合中文开发者的任务说明模板，帮助 Codex 更快理解目标、范围、约束和验收标准。
Codex任务描述提示词
高质量 Codex 任务通常不是一句“帮我优化一下”，而是一段结构清楚的工作说明。目标越明确，Codex 越容易在代码库里做出可验证的修改。
推荐模板
可以从下面的结构开始：
目标：我要实现什么用户可见或工程可见的结果。
背景：为什么要做，当前问题是什么。
范围：哪些文件、页面、模块或行为需要涉及。
约束：必须沿用哪些技术栈、设计风格或接口约定。
验收：如何判断完成，包括测试、构建或人工检查点。
示例
请为现有 Next.js 项目增加文章详情页。
文章来自本地 MDX 文件，路由为 /news/[slug]。
沿用当前 Tailwind 风格，不引入 CMS。
完成后运行 lint 和 build，并说明新增页面如何验证。
常见误区
不要把关键约束藏在后续补充里。比如“不能改接口”“必须兼容旧数据”“页面要静态生成”都应该在一开始说清楚。
当任务较大时，先让 Codex 输出计划，再进入实现，会更容易控制范围。
相关教程
常见问题
这篇内容适合谁阅读？
适合关注 Codex、AI 编程工作流和中文技术内容生产的开发者、技术负责人、测试工程师与内容编辑。
可以直接用于团队实践吗？
建议结合你的项目约束、版本信息、权限策略和验证流程调整后再落地。