SuperAPI AI 工具集

browser-verification

测试与质量

查看项目

更新于 10-16 04:32

技能介绍

用途:在实现完成后、代码审查之前,用真实浏览器验证 UI 改动,提前发现仅在浏览器中暴露的 CSS 问题、运行时 JavaScript 错误、响应式/布局问题以及缺失的视觉元素。

触发条件:仅在 /work 工作流中,实现者完成修改 UI 相关文件的任务后触发,不是独立技能。需同时满足三项可测试性条件:具备浏览器工具(Playwright MCP 工具 mcp__plugin_playwright_* 或 Chrome 扩展工具 mcp__claude-in-chrome__*);开发端口 3000-9999 上有 HTTP 服务器,或可通过 package.json 脚本启动;任务修改了影响浏览器输出的文件,如 .html、.css、.scss、.less、.tsx、.jsx、.vue、.svelte、模板文件(.hbs、.ejs、.pug)以及 components/、views/、ui/、pages/ 下的文件。任一条件不满足则静默跳过。

验证流程:导航到开发服务器,截取初始状态截图,分析页面快照中的预期元素,若任务涉及交互行为则测试交互,检查控制台 JavaScript 错误,最后带证据报告通过或失败。

建议性行为:这不是硬性关卡。若验证提示问题但用户认为实现正确,用户可提供跳过理由,理由会记录在任务备注中,工作继续进入规格审查并带警告标记。

配置:项目可在 .pokayokay.json 中自定义,例如设置 browserVerification 的 enabled、portRange、additionalPaths、excludePaths。

不适用场景:单元/集成测试应使用 testing-strategy 处理测试架构;仅 API 改动属于后端任务,会自动跳过浏览器验证。

集成位置:yokay-implementer → browser-verify → yokay-spec-reviewer → yokay-quality-reviewer → complete,即浏览器验证在实现之后、规格审查之前运行。

运行时说明:Claude Code 中通过 Task 工具以 subagent_type: "pokayokay:yokay-browser-verifier" 派发;Codex 中没有子代理派发,需内联执行该角色,读取对应 agents/yokay-<name>.md 并遵循其行为默认值、关键规则与输出契约。

限制:资料未提供具体收费、价格、平台支持范围或效果数据,暂未提供。