模块 2 · 把任务说明白

写出可直接执行的
任务提示词

把前两节整理出的要求,写成一条 Codex 看完就能开始执行的提示词。

预计阅读 28 分钟视频建议 24—30 分钟登录后免费核验于 2026.08.18

大家好,我是云途。

到这里,我们已经写好了任务说明和完成检查。现在把它们整理成一条可以直接发给 Codex 的提示词。

提示词不用写成长论文。Codex 只需要看懂五件事:先读什么、要改什么、哪些地方不能碰、改完怎样检查、遇到什么情况先停。

这一节会分别给出小任务和中型任务的写法。你可以按照任务大小选择,不用每次都套最长模板。

这节课要完成什么

  1. 知道一条任务提示词要写哪七项内容;
  2. 让 Codex 先查看,再修改,最后检查;
  3. 小任务写短一点,大任务再增加计划;
  4. 长材料只提供路径,不全部复制进消息;
  5. 要求 Codex 写清改动和检查结果。

可执行提示词的七个要素

动作

研究、诊断、修改、创建、验证还是审查。

目标

完成后用户得到什么具体变化。

范围

版本、路径、页面、文件和允许影响的系统。

依据

项目规则、内容真源、参考图与当前事实。

约束

不能改变的行为、数据、品牌和外部边界。

验证

测试、视口、操作路径、截图和业务核对。

交付

文件清单、结果、证据、风险与记录。

顺序比礼貌词更重要

推荐执行顺序FLOW
1. 读取工作区规则与任务真源
2. 调查当前实现并复现问题
3. 说明根因与最小方案
4. 在授权范围内实施
5. 运行自动检查
6. 完成真实操作与视觉复核
7. 整理交付报告并更新状态

如果任务要求“先直接改,之后再找原因”,很容易形成补丁叠补丁。提示词应把现状调查放在实现前,把验证放在“已完成”之前。

低风险小任务可以很短

小任务提示词PROMPT
读取当前练习目录和 README.md。
只把标题“练习目标”改为“本周练习目标”,其他内容保持不变。
修改后展示差异并重新读取全文。
不要创建文件、安装依赖或访问网络。

任务小、真源唯一、结果可见、恢复简单时,不需要堆砌背景。关键边界仍然不能省略。

中型实现任务使用完整结构

可复制提示词

在官网 v4 暖黑视觉实验版中完成 Codex 课程第 03—17 节。先读取根目录规则、工作区状态、课程计划和现有第 01—02 节,确认只操作 v4 实验项目与学习课题真源。建立共享课程数据与页面渲染,保持现有暖黑 Read 模式、页眉页脚和正文排版。课程总目录和四个模块可以收起、展开;默认展开当前模块;只有当前章节显示选中面板;桌面端右侧保留本文目录。每节包含开场、目标、概念解释、真实步骤、代码或输出示例、可复制提示词、常见错误、完成检查、视频提纲和官方依据。不得修改正式 v2.2.1、后端、数据库或生产环境。完成后运行 lint、构建和全部路由渲染测试,并在桌面和手机真实检查展开、跳转和横向溢出。交付修改文件、17 节路由结果、视觉证据、仍未覆盖项,并更新工作区状态。

把停止条件写进提示词

  1. 发现操作版本与用户描述不一致;
  2. 多个真源无法判断优先级;
  3. 需要连接生产系统或使用真实凭据;
  4. 必须删除、覆盖或批量迁移超出原范围的数据;
  5. 测试失败原因与本轮修改无关且无法安全绕过;
  6. 关键业务选择缺失,不同选择会导致完全不同结果。

停止条件不是让 Codex遇到困难就放弃。它只用于防止在缺少授权或关键判断时继续扩大影响。普通实现难点应先调查替代方案。

长材料给路径,不要全部粘贴进消息

Codex 为了理解任务而读取的规则、文件和对话内容,统称为“上下文”。下面这张表可以帮助你决定哪些内容直接写、哪些让它自己读。

直接写

本轮目标、范围、禁止项、验收和用户刚刚确认的选择。

提供路径

长文档、设计系统、课程真源、测试和历史报告。

让 Codex 查

相关组件、路由、数据结构、项目脚本和实际运行状态。

不要提供

与任务无关的整库内容、密码、验证码、真实密钥和未经授权客户数据。

反馈也要写成下一条可执行任务

低效反馈与有效反馈EXAMPLE
【低效】
还是不对,你再看看。

【有效】
当前模块折叠正确,但当前章节仍像独立按钮。
保留展开逻辑,只调整未选章节:移除边框和背景;
当前章节继续保留抬升面板;
用第 01、02、14 节各检查一次选中态跟随。

反馈应该指出已经正确的部分、仍然不对的观察、本轮只改什么,以及怎样确认没有破坏前一轮。

最终模板:任务、顺序、证据、停止

可执行提示词模板MARKDOWN
目标:…
范围:…
依据:…
保留:…
禁止:…

执行顺序:
1. 先读规则与现状
2. 说明根因和最小方案
3. 实施
4. 自动检查 + 真实操作

验收:…
交付:…
停止条件:…

模板不是越长越专业。删掉任何不影响执行的套话,保留会改变路径、方案、风险和验收的信息。

视频录制与复习提纲

  1. 用七要素审查一条提示词;
  2. 比较低风险短任务与中型实现任务;
  3. 演示为什么要先调查再改;
  4. 加入停止条件并解释触发场景;
  5. 把用户反馈改写成下一轮任务;
  6. 用最终模板独立写一条真实提示词。
完成检查

读完就能开始,做完也知道如何停

  • 提示词的动作和目标明确;
  • 范围、依据与禁止项足够具体;
  • 调查、实施、验证顺序清楚;
  • 验收条件带有证据方法;
  • 高风险场景有停止条件;
  • 交付要求能让我独立复核。

官方依据与延伸阅读

Codex 提示与任务说明Codex 使用案例