写出一份
不会让 Codex 猜的任务书

这节课要完成什么

你会把一句模糊的要求，整理成一份 Codex 能照着执行的任务说明。

1. 目标：做完以后会发生什么变化；
2. 背景：为什么现在要做；
3. 范围：允许查看和修改哪些地方；
4. 禁止项：明确哪些地方不能碰；
5. 参考依据：遇到冲突时以哪份文件或页面为准；
6. 完成说明：做完以后必须告诉你什么。

先把感觉变成具体变化

【只有感觉】
这个学习页不够高级，调整一下。

【可以执行】
第 01—17 节使用同一套树状课程目录：
整套课程和 4 个模块可以收起、展开；
只有当前章节显示选中背景；
未选章节保持普通文字行；
保留现有暖黑配色与正文布局。

“不够高级”是重要感受，但它还不能告诉 Codex 改哪里。继续写清层级、选中效果和保留项，Codex 才能开始执行。

目标与背景不要写成同一段

例如“公司正在正规化品牌”是背景；“所有学习文章统一使用 Yuntu Tech 暖黑页眉、页脚和导航”是目标。背景帮助判断，目标决定停止。

范围要写到路径和对象

“只改前端”仍然很宽。好的范围会列出项目版本、允许修改的目录、数据与页面，并同时说明不影响的系统。

项目：官网 v4 暖黑视觉实验版
路径：/…/战略发展/官网v4暖黑视觉初版-20260814/
允许：app/learning/codex、components、data、相关 CSS 与测试
内容真源：/…/学习课题/Codex系统教学/
禁止：v2.2.1 正式版、后端、数据库、生产部署
保留：Logo、暖黑配色、正文排版、共享页眉页脚

材料互相冲突时，以哪一份为准

1. 用户这一次刚刚确认的决定；
2. 项目根目录规则和工作区说明；
3. 当前正在使用的内容文件；
4. 真实页面与测试结果；
5. 旧截图、旧文档和归档只用来参考。

最好在任务里直接写清顺序。截图和当前代码不一致时，Codex 需要知道是照着截图改视觉，还是保留代码中的现有功能。

禁止项要描述风险，不要堆满否定句

禁止项用于挡住高代价偏离，例如不改 Logo、不连接生产数据库、不整包覆盖正式版。普通实现细节不必全部预判，否则任务书会变成难以阅读的防御清单。

做完以后，Codex 要告诉你什么

这里的“交付”，就是 Codex 完成任务后的说明。它至少要包含下面这些内容。

1. 实际修改后的页面或文件；
2. 修改了哪些文件，每个文件负责什么；
3. 运行过哪些检查，结果是什么；
4. 关键页面截图或命令输出；
5. 哪些环境和异常情况还没有检查；
6. 如果新增了长期规则，还要更新对应记录。

一份可以长期复用的任务书模板

# 任务名称

## 目标
完成后用户能看到 / 做到什么。

## 背景
为什么做，当前已确认了什么。

## 范围
项目、路径、页面、允许修改的对象。

## 禁止项
不能影响的版本、数据、品牌和外部系统。

## 事实来源
规则、真源、参考图和冲突优先级。

## 交付物
实现、验证证据、文件清单、风险与记录。

执行前做一次任务书自检

1. 不同的人读完，是否会选择同一个项目和版本；
2. 是否能判断任务什么时候完成；
3. 是否写清最危险的不能做事项；
4. 事实来源冲突时是否有优先级；
5. 有没有把未确认猜测写成事实；
6. 交付物是否足以让你独立复核。

视频录制与复习提纲

1. 从“高级一点”提取真实目标；
2. 分开写目标与背景；
3. 演示范围如何落到绝对路径；
4. 区分高价值禁止项与过度限制；
5. 把截图、规则和源码按优先级排列；
6. 用模板完成一份真实课程目录任务书。