浏览 AI 使用教程
操作教程

Codex检查清单做成Skill:先补证据与失败分支

以页面检查为例,将HTTP状态、图片加载、布局与文案判断拆开;给出可复制流程、结果记录和会被拦截的反例。

Codex项目开发与自动化工作流主视觉
本文目录 · 跳到当前步骤

“页面正常”缺少证据标准。把它写进 Skill,模型仍不知道检查到什么程度可以结束。先把每项变成输入、观察、判定和未覆盖范围。

将一条模糊清单拆成四项

检查 能支持判断的证据 不能据此推出
页面能打开 指定URL的实际HTTP状态与最终跳转地址 内容正确、用户能完成任务
主图已加载 等待加载后的naturalWidth大于0与截图 图片内容与说明相符
指定视口无横向溢出 390px与1440px下的scrollWidth/clientWidth 所有宽度、所有交互都没问题
退款说明与确认规则一致 原规则与页面段落逐条对照 法律、财务或实际退款处理已审核

把执行要求写进已有Skill

下面是可加入已有页面检查 Skill 的正文段落;它依赖客户端已有浏览器能力。没有浏览器或无法访问目标时报告blocked,不能用静态HTML代替实际加载证据。

markdown
## 页面检查任务
输入:指定URL、要检查的图片或区域、需对照的已确认文案。
1. 打开URL,记录请求状态与最终地址;失败则输出blocked与错误。
2. 在390px和1440px分别检查,等待目标图加载,记录naturalWidth与截图。
3. 记录scrollWidth和clientWidth;溢出时指出实际元素,不只截图。
4. 将页面文案与输入规则逐条对照;缺原规则时该项为not-reviewed。
5. 输出page-check.json:每项包含status、evidence、scope、remaining。
不把not-reviewed计入passed;本流程不执行发布或修改付款规则。

同一个失败样本应得到什么

教学样本:页面HTTP 200;主图返回404;390px下scrollWidth=460、clientWidth=390;文案原规则未提供。

json
{
  "http": {"status":"passed","evidence":"HTTP 200","scope":"教学目标URL的页面请求","remaining":"样本未提供最终地址,实际任务需记录"},
  "image": {"status":"failed","evidence":"主图请求返回404","scope":"指定主图","remaining":"修复路径后重新加载,记录naturalWidth与截图"},
  "layout390": {"status":"failed","evidence":"scrollWidth=460,clientWidth=390","scope":"390px视口","remaining":"定位溢出元素并保留截图"},
  "layout1440": {"status":"not-reviewed","evidence":"样本未提供测量","scope":"1440px视口","remaining":"完成该视口的图片与布局检查"},
  "copy": {"status":"not-reviewed","evidence":"未提供原规则","scope":"退款说明","remaining":"获取已确认规则后逐条比对"},
  "overall": {"status":"needs-fix","evidence":"图片缺失且390px溢出","scope":"以上已观察项","remaining":"修复失败项并补齐未覆盖项"}
}

正确结论是“页面能打开,但图片缺失且手机溢出,1440px与文案未审”。若输出“网站检查全部通过”,它把首页可访问误当成完整验收。

再做一个正常样本后才复用

修好测试副本的图片路径和溢出元素后,重复同一视口与加载检查,保留前后证据。原规则仍未提供时,copy 继续为 not-reviewed。更多样本只增加覆盖范围,不能把人工未读的正文自动改成已通过。

下一步

继续阅读与你当前问题相关的教程: