用途:对已运行的 Web 应用做有纪律的视觉 QA(视觉审计)。调度并行子代理,各自驱动 run-agent-browser 技能,负责一组互不重叠的页面,在五档标准视口截图,并为每个真实缺陷写一份 Markdown 发现记录,最终形成 css-issues/ 单一真相源,供后续修复环节按文件逐个处理。
触发场景:审计 UI、检查站点视觉缺陷、查找 CSS 问题、设计 QA、为每页截图找布局断裂、测试多视口页面、跨站检查响应式断点、上线前视觉排查等。不适用:单页 UI 调试(直接用 run-agent-browser 内联处理更划算,页面少于 5 条时开销不划算)、功能/行为测试(用 run-playwright 类工具)、仅无障碍审计、性能审计(Lighthouse / Web Vitals),以及执行修复(修复是独立操作,读取本清单再改源码)。
工作流分四阶段。阶段一验证前置条件:确认开发或生产服务器可达,curl -s -o /dev/null -w "%{http_code}" <url> 应返回 200;本地服务未启动需先后台启动并等待就绪;确认 run-agent-browser 技能可用,若无则停止;明确需要审计的全部路由。阶段二先在项目根写入 css-issues/README.md 作为格式权威(内容照抄 references/audit-format-spec.md,勿改写),并创建 css-issues/screenshots/。阶段三按目录归属拆分页面并调度子代理,使用 references/subagent-prompt-template.md 的提示模板。关键限制:不要完全并行调度浏览器型审计,run-agent-browser 基于共享 Chrome 守护进程与 SingletonLock,同批四个子代理会互相争抢会话、多数返回零发现;应采用分批错峰(每次 2 个,等一批返回再发下一批)或单实例串行。阶段四汇总:用 find css-issues -name "*.md" -not -name "README.md" | wc -l 和 ls css-issues/screenshots/ | wc -l 清点,按区域与严重度统计,提炼跨页系统性模式,向用户报告分诊表,未经明确授权不要开始修复。
标准视口:Desktop XL 1440×900、Desktop M 1280×800、Tablet 1024×768、Mobile L 768×1024、Mobile S 375×812。每页至少桌面与移动两档,中间断点仅在存疑时补充。
严重度:critical(内容不可读、布局破裂阻碍理解、重叠导致卡片不可点、首屏看不到 hero/CTA)、major(明显视觉破损但仍可用)、minor(打磨类间距、对比度、悬停状态、动画时序)。
截图前缀约定:homepage-<context>-<NN>-<slug>.png、feat-<slug>-<context>-<NN>-<slug>.png、stub-<route>-<context>-<NN>-<slug>.png;拆分功能页时用 feat1-、feat2- 等区分。
常见坑:完全并行导致锁争用;子代理只调查不记录而耗尽预算(DoD 设数量下限:首页 ≥15、10 个功能页合计 ≥15、存根页合计 ≥7);发现记录缺少 截图引用视为无效;为凑数编造问题会污染清单;同一缺陷跨页重复记录应只记一次并注明影响范围;调度前忘记先放 README.md 会导致格式不可合并。
产出结构:css-issues/ 下含 README.md、screenshots/ 与按区域/语境分层的目录,每个真实缺陷一份 .md,模板见 references/audit-format-spec.md。参考文件还有 references/subagent-prompt-template.md 与 references/footguns.md。
写作要求:描述所见事实而非主观判断。以上信息来自公开资料,收费与定价等未提供。