大家好,我是云途。
到这里,我们已经写好了任务说明和完成检查。现在把它们整理成一条可以直接发给 Codex 的提示词。
提示词不用写成长论文。Codex 只需要看懂五件事:先读什么、要改什么、哪些地方不能碰、改完怎样检查、遇到什么情况先停。
这一节会分别给出小任务和中型任务的写法。你可以按照任务大小选择,不用每次都套最长模板。
这节课要完成什么
- 知道一条任务提示词要写哪七项内容;
- 让 Codex 先查看,再修改,最后检查;
- 小任务写短一点,大任务再增加计划;
- 长材料只提供路径,不全部复制进消息;
- 要求 Codex 写清改动和检查结果。
可执行提示词的七个要素
研究、诊断、修改、创建、验证还是审查。
完成后用户得到什么具体变化。
版本、路径、页面、文件和允许影响的系统。
项目规则、内容真源、参考图与当前事实。
不能改变的行为、数据、品牌和外部边界。
测试、视口、操作路径、截图和业务核对。
文件清单、结果、证据、风险与记录。
顺序比礼貌词更重要
1. 读取工作区规则与任务真源
2. 调查当前实现并复现问题
3. 说明根因与最小方案
4. 在授权范围内实施
5. 运行自动检查
6. 完成真实操作与视觉复核
7. 整理交付报告并更新状态如果任务要求“先直接改,之后再找原因”,很容易形成补丁叠补丁。提示词应把现状调查放在实现前,把验证放在“已完成”之前。
低风险小任务可以很短
读取当前练习目录和 README.md。
只把标题“练习目标”改为“本周练习目标”,其他内容保持不变。
修改后展示差异并重新读取全文。
不要创建文件、安装依赖或访问网络。任务小、真源唯一、结果可见、恢复简单时,不需要堆砌背景。关键边界仍然不能省略。
中型实现任务使用完整结构
在官网 v4 暖黑视觉实验版中完成 Codex 课程第 03—17 节。先读取根目录规则、工作区状态、课程计划和现有第 01—02 节,确认只操作 v4 实验项目与学习课题真源。建立共享课程数据与页面渲染,保持现有暖黑 Read 模式、页眉页脚和正文排版。课程总目录和四个模块可以收起、展开;默认展开当前模块;只有当前章节显示选中面板;桌面端右侧保留本文目录。每节包含开场、目标、概念解释、真实步骤、代码或输出示例、可复制提示词、常见错误、完成检查、视频提纲和官方依据。不得修改正式 v2.2.1、后端、数据库或生产环境。完成后运行 lint、构建和全部路由渲染测试,并在桌面和手机真实检查展开、跳转和横向溢出。交付修改文件、17 节路由结果、视觉证据、仍未覆盖项,并更新工作区状态。
把停止条件写进提示词
- 发现操作版本与用户描述不一致;
- 多个真源无法判断优先级;
- 需要连接生产系统或使用真实凭据;
- 必须删除、覆盖或批量迁移超出原范围的数据;
- 测试失败原因与本轮修改无关且无法安全绕过;
- 关键业务选择缺失,不同选择会导致完全不同结果。
停止条件不是让 Codex遇到困难就放弃。它只用于防止在缺少授权或关键判断时继续扩大影响。普通实现难点应先调查替代方案。
长材料给路径,不要全部粘贴进消息
Codex 为了理解任务而读取的规则、文件和对话内容,统称为“上下文”。下面这张表可以帮助你决定哪些内容直接写、哪些让它自己读。
本轮目标、范围、禁止项、验收和用户刚刚确认的选择。
长文档、设计系统、课程真源、测试和历史报告。
相关组件、路由、数据结构、项目脚本和实际运行状态。
与任务无关的整库内容、密码、验证码、真实密钥和未经授权客户数据。
反馈也要写成下一条可执行任务
【低效】
还是不对,你再看看。
【有效】
当前模块折叠正确,但当前章节仍像独立按钮。
保留展开逻辑,只调整未选章节:移除边框和背景;
当前章节继续保留抬升面板;
用第 01、02、14 节各检查一次选中态跟随。反馈应该指出已经正确的部分、仍然不对的观察、本轮只改什么,以及怎样确认没有破坏前一轮。
最终模板:任务、顺序、证据、停止
目标:…
范围:…
依据:…
保留:…
禁止:…
执行顺序:
1. 先读规则与现状
2. 说明根因和最小方案
3. 实施
4. 自动检查 + 真实操作
验收:…
交付:…
停止条件:…模板不是越长越专业。删掉任何不影响执行的套话,保留会改变路径、方案、风险和验收的信息。
视频录制与复习提纲
- 用七要素审查一条提示词;
- 比较低风险短任务与中型实现任务;
- 演示为什么要先调查再改;
- 加入停止条件并解释触发场景;
- 把用户反馈改写成下一轮任务;
- 用最终模板独立写一条真实提示词。
读完就能开始,做完也知道如何停
- 提示词的动作和目标明确;
- 范围、依据与禁止项足够具体;
- 调查、实施、验证顺序清楚;
- 验收条件带有证据方法;
- 高风险场景有停止条件;
- 交付要求能让我独立复核。