大家好,我是云途。
上一节写清了 Codex 要做什么。这一节,我们继续写清“做到什么程度才算完成”。这份检查清单叫验收条件。
例如,“适配手机”还不够具体。可以改成:在 390px 宽的手机页面上没有左右滚动,标题不被截断,按钮可以点击。
接下来,我们会把“更高级、更完整、没有问题”这类模糊说法,变成可以亲自检查的结果。
这节课要完成什么
- 识别不可验收的模糊词;
- 从功能、内容、视觉、响应式、安全和证据六个方向写条件;
- 给每条条件配验证方法;
- 区分自动检查与人工判断;
- 记录本轮明确不覆盖的状态。
这些句子听起来正确,却无法验收
谁来判断?具体是亮度、层级、材质、字体、间距还是动效?
哪条交互路径、什么状态、在哪个设备上?
最低宽度、横向溢出、标题行数和触控目标分别如何?
需要哪些章节、代码框、练习和依据?
哪些测试,测试能证明什么,真实操作是否仍需检查?
检查网页时,至少看这六类问题
入口、点击、展开、跳转、提交和返回是否按预期工作。
标题、层级、事实、免费状态和课程顺序是否正确。
选中态、对比度、间距、容器边界和品牌规则是否一致。
桌面、平板、手机以及长标题时是否可读、可操作、无溢出。
没有越过版本、权限、账号、数据库和外部操作边界。
有测试输出、操作路径、截图、文件清单和未覆盖说明。
把感觉写成可以检查的结果
反馈:目录像一排按钮,不像飞书的层级。
检查:
- 课程总目录可以收起和展开
- 4 个模块可以分别收起和展开
- 默认只展开当前章节所在模块
- 只有当前章节显示边框和背景
- 其他章节保持普通文字行
- 箭头会跟随展开状态旋转
- 使用键盘也能切换折叠视觉感受仍然要由用户最后判断。先把能写清楚的结构和操作列出来,修改过程会更稳定。
每条条件后面都写验证方式
适合路由状态、文本存在、数据结构和稳定逻辑。
适合语法、类型、无障碍规则、构建与依赖问题。
适合点击、键盘、滚动、加载、弹窗、视口和外部流程。
适合层级、质感、品牌一致性、长文节奏和截图对照。
适合价格、权益、课程结构、公司名称和真实数据。
一条条件可能需要多个证据。例如“课程目录在手机可用”既要无横向溢出,也要真实展开、点击并回到正确文章。
给验收条件标优先级
- 必须通过:不通过就不能交付,例如路由错误、数据风险、当前章节选错;
- 人工确认:实现完成但需要用户判断,例如亮度、标题气质、信息密度;
- 后续覆盖:本轮明确不做,例如真实登录、Safari 旧版本、生产数据;
- 禁止回归:原本正确且本轮必须保持,例如共享页眉页脚、黑白 Logo、正文排版。
验收清单模板
## 必须通过
- [ ] 功能:…(验证:…)
- [ ] 内容:…(依据:…)
- [ ] 响应式:…(视口:…)
- [ ] 安全:…(边界:…)
## 人工确认
- [ ] 视觉层级:…
- [ ] 文案感觉:…
## 禁止回归
- [ ] …
## 本轮不覆盖
- …请把下面的目标改写成验收条件。分别覆盖功能、内容、视觉、响应式、安全和交付证据;每条写明验证方式。再分成“必须通过”“需要我人工确认”“禁止回归”“本轮不覆盖”。不要用“更好、更高级、正常、完整”作为最终条件。
别把验收写成实现方案
“使用 React useState”“新增 24px padding”“做成手风琴组件”是实现方式,不一定是用户结果。除非技术选择本身受项目规则约束,否则验收应写“可以独立折叠”“边界与首页一致”“刷新后当前章节可识别”。
验收条件固定结果与边界,实现方案保留调查后的选择空间。
视频录制与复习提纲
- 逐个拆解五个模糊质量词;
- 用课程目录反馈生成八条条件;
- 给条件匹配自动、真实和人工证据;
- 区分必须通过与人工确认;
- 展示把 CSS 数字误写成验收的反例;
- 完成一份可直接勾选的清单。
检查清单能逐条勾选,任务才知道在哪里结束
- 每条条件都描述可观察结果;
- 功能、内容、视觉、响应式和安全均有覆盖;
- 每条条件配有验证方式;
- 主观判断被单独标注为人工确认;
- 禁止回归与本轮不覆盖已经写明;
- 验收没有把一种实现方式误当成唯一结果。