seo-visual 是 SEO 全站审计中的可视化专项子技能,用于采集页面截图、评估首屏信号并检查移动端渲染基础。
用途:在完整审计中承担可视化子线,独立执行全新的可视化检查,不依赖上游缓存数据即可运行。
主要能力:检查首屏内 H1 与 CTA 是否可见;检查移动端视口与横向滚动;检查触控目标尺寸与最小字号;在可用时进行多视口截图。
输入:URL、超时时间、可视化模式(on|off|auto)。
输出:VISUAL-AUDIT-REPORT.md、SUMMARY.json,以及 Playwright 可用时的 screenshots/ 目录。
共享数据缓存:运行前检查 .seo-cache/ 中其他技能留下的缓存,模式与依赖关系参考 ../seo/references/shared-data-cache.md。本专项无需上游缓存输入;缓存存在则继续当前截图流程,缺失则正常采集新数据,JSON 损坏则按缺失处理,用户说 refresh 或 re-run 时完全忽略缓存。完成后写入缓存:mkdir -p .seo-cache/pages/{url-slug},并按该文档的 schema 写入 .seo-cache/pages/{url-slug}/visual.json,保留 cache_type、analyzed_at、url、url_slug、score、layout_summary、issues 等顶层键,额外可视化细节仅作为补充字段,例如 above_fold、mobile、screenshots、notes。如未忽略,需将 .seo-cache/ 加入 .gitignore:grep -qxF '.seo-cache/' .gitignore 2>/dev/null || echo '.seo-cache/' >> .gitignore。
高级交付物:用户要求 client report 或 premium deliverable 时,读取 ../seo-audit/assets/report-template.html 与 ../seo/references/premium-report-standard.md,以该报告标准为默认简报,HTML 作为内部中间产物,PDF 作为对外交付物;除非用户明确索要 HTML,最终回复只提及 PDF。
限制:资料未说明具体价格、平台支持范围或截图以外的效果保证;部分能力依赖 Playwright 是否可用。