SuperAPI AI 工具集

ux-gap-detector

测试与质量

查看项目

更新于 10-15 23:49

技能介绍

用途:在已登录的 SaaS 网页应用中进行 UI/UX 质量差距审计。它通过 playwright-cli 使用用户真实 Chrome 配置(含 Cookie、会话、localStorage)进行实时浏览器交互,技能本身不执行登录,用户必须已在 Chrome 登录并连接 playwright-cli 扩展。

主要能力:按类别执行审计场景,类别包括 dashboard(概览、组件、图表、KPI)、data-management(表格、列表、CRUD、搜索/筛选)、form workflow(多步表单、输入校验、提交)、navigation shell(侧边栏、顶栏、命令面板、面包屑)、settings & profile。流程分为:Phase 0 设置(加载 /dnd 拖放验证协议、截图确认扩展连接、导航到目标 URL、选择审计类别、创建 docs/ux-gap-reports/screenshots 目录与报告文件名);Phase 1 应用发现(截图、快照无障碍树、识别导航元素并列出可发现路由);Phase 2 场景执行(每步先 browser_snapshot 获取元素引用,再用 browser_click、browser_hover、browser_type、browser_select_option、browser_press_key、browser_navigate 等操作,browser_wait 1-3 秒后截图保存);Phase 3 差距分析(用 mcp__sequential-thinking__sequentialthinking 逐维度打分:排版与间距 25 分、交互状态 25 分、内容层级 25 分、加载与错误 UX 25 分,并为低于 75 的缺口给出修复建议,优先级以 <50 为严重、50-75 为中等);Phase 4 生成 Markdown 报告;Phase 5 询问用户后将选中缺口用 gh issue create 登记为 GitHub Issue。

使用方式:调用 /ux-gap-detector(交互式询问类别与 URL),或带参数 /ux-gap-detector --category dashboard、--category data-management。前提是在 Chrome 中已登录目标应用并连接 playwright-cli 扩展。在 Codex 或 Cursor 中运行需按文档说明转换 Claude Code 专有原语与路径。

限制:不会自行登录任何服务,不执行破坏性操作(删除、修改数据),不更改应用设置,不提交真实生产表单数据,不访问用户未导航过的页面,不绕过安全措施。关于费用、价格、平台支持范围等资料暂未提供。