UI Verify 可视化回归分诊技能用于让编程智能体通过 UI Verify MCP 审查构建中的变更，而不必打开仪表盘。
用途与前提： 当 UI Verify 构建报告变更或失败故事，用户希望由智能体审查、为 PR 总结视觉回归、接受新基线、展示 PR 变更前后 UI，或回复/解决审查评论时使用。需要一个从 CI 上传构建的 UI Verify 项目，并在智能体中连接 UI Verify MCP 服务器。
连接方式： 服务器为远程 Streamable-HTTP MCP，地址 https://uiverify.ai/mcp 。通过浏览器使用 UI Verify 账户 OAuth 登录一次，即可访问所属团队中的所有项目，无需逐项目配置或 API 密钥。应作为原生 MCP 服务器添加，而非手写 curl；原生客户端可直接向模型展示图像。
Claude Code 在项目根目录运行： claude mcp add --scope project --transport http uiverify https://uiverify.ai/mcp 然后重启 Claude Code，运行 /mcp，选择 uiverify 并登录。--scope project 写入提交的 .mcp.json，不含密钥，团队成员各自登录。
Cursor 添加到 .cursor/mcp.json 并提交共享，然后从 Cursor 的 MCP 设置登录： { "mcpServers": { "uiverify": { "url": "https://uiverify.ai/mcp" } } }
其他 MCP 客户端（VS Code、Codex、Copilot、Gemini）指向同一 URL 并登录。若只能手动 HTTP 访问，优先使用 get_diff（返回可下载图片 URL）而非 render_diff_image（内联像素）。
主要工具能力： list_projects 列出可访问项目；list_builds 列出近期构建与门禁状态；get_build 提供单个构建的计数（总数、变更、失败、未变）、评论统计和首批 25 个变更/失败故事；list_build_stories 按状态分页浏览；get_diff 返回逐故事差异指标、预设图片 URL 及 AI 判定；render_diff_image 内联展示基线/候选/差异或前后对比裁切图；get_pr_changeset 返回 PR 相对基线的累计新增/变更/移除故事集；list_pr_stories 分页；review_diff 记录接受、拒绝或忽略决定；accept_build 一次接受全部变更故事；评论工具 list_comments、post_comment、resolve_comment、update_comment、delete_comment 受团队图像评论功能控制。
使用流程要点： 分诊时先看 get_build 的 AI 判定作为参考，再独立渲染基线和候选图对比，不只看差异掩码；阅读未解决评论并处理后再接受。报告分为回归、预期变更、外观重排、候选渲染噪声四类，附故事名和百分比。汇总时先列回归再列预期内容变更，形成 PR 评论。接受全部基线前确认无回归隐藏；针对性接受则逐故事调用 review_diff。前后对比图可用 render_diff_image 的 before_after，或 get_diff 的 URL 下载。检查整个 PR 需用 get_pr_changeset，避免漏掉已接受新增故事和删除故事。评论回复用 post_comment，解决用 resolve_comment。
限制： 评论相关工具仅在团队启用图像评论功能时可用；未启用时评论计数显示为零。接受和忽略在有未解决评论时会被拒绝，拒绝始终可用。智能体只能修改自己发表的评论。分诊步骤本身不应直接接受，应交由用户决定或按明确流程执行。