模块 2 · 把任务说明白

把“做好”
变成验收条件

把“更高级、能用、适配手机”这类模糊要求,改成做完以后可以逐条勾选的检查清单。

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

大家好,我是云途。

上一节写清了 Codex 要做什么。这一节,我们继续写清“做到什么程度才算完成”。这份检查清单叫验收条件。

例如,“适配手机”还不够具体。可以改成:在 390px 宽的手机页面上没有左右滚动,标题不被截断,按钮可以点击。

接下来,我们会把“更高级、更完整、没有问题”这类模糊说法,变成可以亲自检查的结果。

这节课要完成什么

  1. 识别不可验收的模糊词;
  2. 从功能、内容、视觉、响应式、安全和证据六个方向写条件;
  3. 给每条条件配验证方法;
  4. 区分自动检查与人工判断;
  5. 记录本轮明确不覆盖的状态。

这些句子听起来正确,却无法验收

更高级

谁来判断?具体是亮度、层级、材质、字体、间距还是动效?

交互顺滑

哪条交互路径、什么状态、在哪个设备上?

适配手机

最低宽度、横向溢出、标题行数和触控目标分别如何?

内容完整

需要哪些章节、代码框、练习和依据?

测试通过

哪些测试,测试能证明什么,真实操作是否仍需检查?

检查网页时,至少看这六类问题

功能

入口、点击、展开、跳转、提交和返回是否按预期工作。

内容

标题、层级、事实、免费状态和课程顺序是否正确。

视觉

选中态、对比度、间距、容器边界和品牌规则是否一致。

响应式

桌面、平板、手机以及长标题时是否可读、可操作、无溢出。

安全

没有越过版本、权限、账号、数据库和外部操作边界。

证据

有测试输出、操作路径、截图、文件清单和未覆盖说明。

把感觉写成可以检查的结果

从感受走到检查清单EXAMPLE
反馈:目录像一排按钮,不像飞书的层级。

检查:
- 课程总目录可以收起和展开
- 4 个模块可以分别收起和展开
- 默认只展开当前章节所在模块
- 只有当前章节显示边框和背景
- 其他章节保持普通文字行
- 箭头会跟随展开状态旋转
- 使用键盘也能切换折叠

视觉感受仍然要由用户最后判断。先把能写清楚的结构和操作列出来,修改过程会更稳定。

每条条件后面都写验证方式

自动测试

适合路由状态、文本存在、数据结构和稳定逻辑。

静态检查

适合语法、类型、无障碍规则、构建与依赖问题。

真实操作

适合点击、键盘、滚动、加载、弹窗、视口和外部流程。

视觉复核

适合层级、质感、品牌一致性、长文节奏和截图对照。

业务核对

适合价格、权益、课程结构、公司名称和真实数据。

一条条件可能需要多个证据。例如“课程目录在手机可用”既要无横向溢出,也要真实展开、点击并回到正确文章。

给验收条件标优先级

  1. 必须通过:不通过就不能交付,例如路由错误、数据风险、当前章节选错;
  2. 人工确认:实现完成但需要用户判断,例如亮度、标题气质、信息密度;
  3. 后续覆盖:本轮明确不做,例如真实登录、Safari 旧版本、生产数据;
  4. 禁止回归:原本正确且本轮必须保持,例如共享页眉页脚、黑白 Logo、正文排版。

验收清单模板

可复制的验收结构MARKDOWN
## 必须通过
- [ ] 功能:…(验证:…)
- [ ] 内容:…(依据:…)
- [ ] 响应式:…(视口:…)
- [ ] 安全:…(边界:…)

## 人工确认
- [ ] 视觉层级:…
- [ ] 文案感觉:…

## 禁止回归
- [ ] …

## 本轮不覆盖
- …
可复制提示词

请把下面的目标改写成验收条件。分别覆盖功能、内容、视觉、响应式、安全和交付证据;每条写明验证方式。再分成“必须通过”“需要我人工确认”“禁止回归”“本轮不覆盖”。不要用“更好、更高级、正常、完整”作为最终条件。

别把验收写成实现方案

“使用 React useState”“新增 24px padding”“做成手风琴组件”是实现方式,不一定是用户结果。除非技术选择本身受项目规则约束,否则验收应写“可以独立折叠”“边界与首页一致”“刷新后当前章节可识别”。

验收条件固定结果与边界,实现方案保留调查后的选择空间。

视频录制与复习提纲

  1. 逐个拆解五个模糊质量词;
  2. 用课程目录反馈生成八条条件;
  3. 给条件匹配自动、真实和人工证据;
  4. 区分必须通过与人工确认;
  5. 展示把 CSS 数字误写成验收的反例;
  6. 完成一份可直接勾选的清单。
完成检查

检查清单能逐条勾选,任务才知道在哪里结束

  • 每条条件都描述可观察结果;
  • 功能、内容、视觉、响应式和安全均有覆盖;
  • 每条条件配有验证方式;
  • 主观判断被单独标注为人工确认;
  • 禁止回归与本轮不覆盖已经写明;
  • 验收没有把一种实现方式误当成唯一结果。

官方依据与延伸阅读

Codex 使用案例与验证实践Codex 任务提示指南