落地页审核
你审计一个落地页并将裁决写入 landing/review.md。页面可以来自 landing-skills 管道或任何其他地方。你阅读源码,在四种宽度下查看渲染后的页面,如果有运动或3D效果则进行测试,并根据一个评分标准对所有内容进行评判。
看起来已完成的页面通常存在无人查找的缺陷:丢弃每条潜在客户却感谢访客的表单、客户从未给出的规格和承诺、WebGL不可用时变空白的3D页面、在任何宽度下都被另一条规则取消的部分内边距。捕捉四个宽度却只看其中两个的审核者会错过只在一个宽度下才显现的问题。你的工作是查看所有内容,并只报告你已确认的内容。
下面的 <skill-dir> 表示包含此 SKILL.md 的目录;脚本位于其 scripts/ 文件夹中。当技能从插件加载时,此文件的路径在加载时已提供给你;如果没有,请使用 find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null 找到它。在待审核的项目中运行每个命令,脚本使用其完整路径指定。
输入
你需要页面,并使用任何存在的上下文。
- 页面。 一个项目目录、单个 HTML 文件或已部署的 URL。找到入口:
index.html、src/pages/index.astro、src/App.jsx、app/page.tsx或堆栈使用的任何内容。记录堆栈;它决定你如何在视觉测试中提供页面。 landing/brief.md:产品、受众、转化动作、客户提供的事实和证明、提供的资源、语言。这是你判断页面可能声称什么的真相来源。landing/copy.md:已批准的文案。将页面与之对比。landing/direction.md和landing/tokens.css:视觉方向及其理由,以及令牌。当方向给出了客户特定的理由时,看起来像默认值的选择是可以接受的。
当文件缺失时:
- 无 brief。 在判断声明之前,向用户询问四件事:产品是什么、为谁而做、唯一的转化动作是什么、哪些事实、数字、推荐和标识是真实的。如果你无法询问,则从页面本身关于业务的陈述中获取事实,并将每条推荐、客户姓名、标识、评分和指标视为未经证实:将每项报告为阻止者,修复方式为“确认此内容真实且由客户提供,否则删除”。未经证实的证明与编造的证明风险相同。
- 无 copy.md 或 direction.md。 根据评分标准自行评判文案和视觉效果。你失去了说出“这与批准的文案不同”的能力,其他方面不受影响。不要索要这些文件。
- 无
landing/文件夹。 在项目中创建landing/和landing/shots/;报告和截图将放在那里。 - 页面无法构建或提供服务。 在评分标准行 B15 下报告,并附上错误。如果无法以任何其他方式(已部署的 URL、先前的构建)获取渲染后的页面,则视觉测试无法运行,裁决为
incomplete(请参阅裁决)。
在开始测试之前阅读 references/rubric.md。其中包含每项检查以及通过时的样子和失败时的严重级别。在编写 landing/review.md 之前阅读 references/report-format.md。references/snippets.md 包含测试运行的脚本。
流程
按此顺序运行测试,然后编写报告:
- 静态测试:扫描源码,然后阅读它。
- 视觉测试:渲染页面并在四种宽度下查看。
- 运动和 3D 测试:仅在页面包含运动或 3D 场景时进行。
- 逐区域走查
references/rubric.md中的整个评分标准:文案、艺术指导、构建、运动、启动准备。编写一个工作检查清单到landing/review-checklist.md,每行一个检查项 ID:fail并附位置,pass并附证据,或n/a并附理由。仅当通过的证据是该行“如何检查”的输出时才计为通过:列表应列出内容,计数应计数,以及每个章节、页眉和页脚(如适用)都应包含。仅凭记忆勾选的检查项不被视为已走查。对简短静态页面的文案和艺术指导的阅读也应像对复杂页面一样仔细,并且即使一个阻止者已经很明显,也要走查每一行:审核列出了下一轮必须修复的所有内容,而不仅仅是决定裁决的内容。 - 按照
references/report-format.md的描述编写landing/review.md:失败项放在表格中,通过项及其证据放在“已检查且正常”下。然后运行此文件末尾的自检。
边进行边做笔记:对于每项发现,你在哪里看到的(文件和行,或宽度和章节),以及你是如何确认的。
静态测试
将扫描器指向页面的源码路径,而不是整个仓库:
node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json
它读取的内容:你直接命名的任何文件,无论扩展名是什么。对于目录,它读取 .html、.htm、.css、.scss、.js、.jsx、.mjs、.ts、.tsx、.astro、.vue、.svelte、.md 和 .mdx 文件,跳过 node_modules、.git、dist、build、.next、.astro、.output、.vercel 和 .wrangler 文件夹,并跳过任何超过 1 MB 的文件。每行都根据 25 条规则进行检查。发现的结果打印为 file:line [rule-id] 消息,后跟 fix: 行。退出码 1 表示有所发现,0 表示没有发现,2 表示错误的路径或用法。--self-test 检查扫描器本身。
因为它读取 Markdown,所以它也会报告笔记、报告、简报和先前审核中引用的短语。忽略任何不在页面源码中的文件中的发现:landing/*.md、README、笔记、之前的 review.md 文件。
将每条发现视为提示你去查看,而不是裁决。打开该行,查看其实际内容以及页面如何处理它,然后才能做出决定。描述规则匹配的内容:对标签颜色的调色板命中不是关于页面背景的发现。查看结果决定的示例:
- Logo 链接上的
dead-anchor是轻微的构建缺陷。在主行动号召上意味着转化不起作用:一个阻止者。 overused-font意味着一个常见字体主导了字体系列。仅当direction.md没有给出理由且该字体未与不同的显示或等宽字体搭配时,才是一项发现。palette-cream-terracotta触发两个精确的十六进制值。单独的米色从来不是一个线索;米色、赤陶色强调色和时尚衬线字体的组合才是。
干净的扫描证明不了什么。编造的声明、没有 JavaScript 就空白的页面、过大的包、以及链接到有效页面内 id 但从未导致购买的行动号召,都不会在源码中留下模式。大多数失败是缺失、计数、矛盾、构图和中断的行为,逐行的正则表达式无法看到这些。一个页面可能扫描干净,但在其他每个测试中都失败。
因此,在扫描之后,你自己阅读源码。需要阅读检查的内容在 references/rubric.md 中,标记为“源码”。最常抓住问题的检查:
<head>:标题、lang、元描述、favicon、Open Graph 标签。- 每个表单:提交到哪里、处理器如何处理数据、以及成功消息是否等待服务器。
- 每个行动号召的
href:实际去向何处。 - 字体:每个
font-family是否由@font-face、样式表链接或框架字体导入加载,或者仅属于系统堆栈? - 页面上的每个声明、数字、名称、规格和承诺,对照简报进行检查。简报中提供的每个资源,对照页面显示的内容进行检查。
- 自我取消的 CSS,例如一个容器类的
padding简写比章节规则更具体,并静默地将章节的垂直内边距重置为零。通过读取计算后的内边距在浏览器中确认。 prefers-reduced-motion:存在或不存在,以及它做了什么。- 构建后的 HTML 的 body:如果它是一个空的
<div id="root">且没有<noscript>,则页面在没有 JavaScript 的情况下是空白的。
视觉测试
你需要一个渲染后的页面。扫描器和源码无法向你展示重叠、布局的空半部分、换行的标题、折叠的间距或位于 3D 场景之上的文本。
提供页面
始终通过 HTTP 进行审核,即使是纯 HTML。几个检查需要服务器:根相对资源路径(/styles.css、/assets/...)在 file:// 下会失败,并且评分标准行 L7 请求缺失的路径 /robots.txt 和 /sitemap.xml。如果缺少 node_modules,首先安装依赖项。
- 已部署的 URL: 直接使用它。
- 纯 HTML 和 CSS: 在包含
index.html的文件夹中,运行python3 -m http.server 8000并打开http://localhost:8000/。 - Vite:
npm run build,然后npx vite preview(默认端口 4173)。 - Astro:
npm run build,然后npx astro preview(默认端口 4321)。 - Next.js:
npm run build,然后npm start(默认端口 3000)。 - 任何其他构建: 构建它,然后在输出文件夹中运行相同的
python3 -m http.server命令。
在“测试”下写下你审核的 URL。仅当无法提供服务时,才作为最后手段打开 file:// 路径;那么 L7 将不会运行,并且任何具有根相对路径的资源都可能仅因此原因而缺失。在“测试”下列出两者,并且不要报告服务器能够找到的缺失资源。
仅当现有构建输出与源码同步时才审核它。find src index.html -newer dist/index.html(使用堆栈的源码和输出路径)列出自构建以来更改的源文件;如果列出了任何文件,或者没有构建,则重新构建。在“测试”下说明你审核了哪个以及原因。
选择截图方法,按此顺序
-
浏览器工具,如果环境中有的话。你需要这些功能:导航到 URL、设置视口宽度、拍摄全页截图、在页面中运行脚本以及模拟媒体功能(配色方案、减少动画)和关闭 JavaScript。
-
回退脚本,当没有浏览器工具或浏览器工具无法截图时。即使你被告知没有可用的浏览器,也要运行它:它通过
npx启动自己的浏览器,可能仍然有效。node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots --dark它写入
360.png、768.png、1280.png和1440.png(使用--dark时,还有360-dark.png等),全页,等待 1.5 秒后,并打印每个文件路径。如果失败并显示“Executable doesn't exist”,运行npx playwright install chromium并重试。当它以非零退出码退出、打印capture failed at <width>px或未写入图像时,表示它失败了。 -
两者都无效。 只有这样视觉测试才没有运行。无论如何都执行静态测试和源码阅读,然后遵循
incomplete的裁决规则。
回退脚本无法在页面中运行脚本、模拟减少动画、关闭 JavaScript 或 WebGL,或滚动。使用回退脚本时,根据图像判断你能判断的内容,通过阅读源码检查减少动画、关闭 JavaScript 和关闭 WebGL,并在“测试”下列出你无法实时运行的每项检查及其原因。
捕捉所有四种宽度
对于每个宽度,360、768、1280 和 1440(高度 800 即可):
- 设置宽度,加载页面,等待字体和图像。
- 使用
references/snippets.md中的视口检查确认实际宽度。某些工具不会将窗口缩小到低于最小值,并静默地提供给你一个更宽的页面;而是使用该工具的设备或视口模拟,并再次检查。 - 拍摄全页截图到
landing/shots/。 - 运行
references/snippets.md中的测量脚本并阅读其注意事项:溢出、比视口更宽的元素、布局偏移、画布数量。 - 在实时浏览器中从上到下滚动浏览页面。
然后打开并阅读每张图像:所有四个宽度,以及暗色图像(如果你拍摄了它们)。在继续之前,在你的笔记中为每个宽度写一行,说明你看到了什么。只看两个宽度并假设其他宽度就是如何错过那些仅在某些宽度下才显现的失败:在宽宽度下窄块留下行的一半为空,或者在最窄宽度下部分链接隐藏且没有菜单。
如果全页截图失败或返回被截断的结果(在包含画布的冗长页面上常见),则在每个宽度下改为截取视口顶部和多个滚动位置(四分之一、一半、四分之三、底部)的截图,并在“测试”下说明。回退脚本仅拍摄全页截图;如果它以这种方式失败,记录哪些宽度缺失。
滚动驱动页面的全页截图可能会显示空白带,其中视差或粘性部分在滚动位置为零时位于屏幕外。在报告空白区域之前,在实时页面中滚动到该位置。如果它在那里渲染,则是截图伪影,而不是缺陷。
查找内容
在每个宽度下,打开评分标准:
- 水平滚动、裁剪的文本、重叠的元素、位于图像或画布上方的文本,使其难以阅读。
- 间距:没有垂直内边距的章节、与上方块齐平且无间距的标题、伸出内容之外的边框。
- 构图:1280 和 1440 下半空的行、换行到四行或在最后一行留下单个单词的标题、眉毛文字、标签和按钮在 360 处换行、高度不一的卡片。
- 360 处的导航:部分链接是否仍然可达、按钮是否至少 44 乘 44 像素、固定页眉是否覆盖标题?
- 360 处的顺序:产品在表单上方可见,还是被推到下方?
- 图像:真实资源,还是针对尚不存在的资源以正确宽高比标记的占位符?
- 键盘:在 1280 处 Tab 浏览页面一次。焦点必须...
[... 已截断,因为原始内容被截断,但翻译继续正确翻译所提供的内容]
(注意:原始内容被截断,但翻译遵循指示翻译了提供的所有内容。由于原始 SKILL.md 内容被截断,翻译也在此处截断。完整的翻译将基于原始文档的完整内容。)