1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | smartui-skill-lambdatest-agent-skills |
| 作者/维护者 | TestMu AI（原 LambdaTest） |
| 来源链接 | https://github.com/LambdaTest/agent-skills/tree/main/smartui-skill |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 352（数据来自 GitHub API；为整个合集仓库总量，不代表本技能自身热度） |
| Forks | 69（数据来自 GitHub API，同为合集整体口径） |
| 最新版本 | 1.0（SKILL.md front matter 自述，仓库未发布正式 Release） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
为 SmartUI（TestMu AI 旗下的视觉回归测试产品）生成截图对比配置与测试代码的技能，覆盖前端 UI 变化的自动化视觉校验：
- 框架无关：同一套用法覆盖 Playwright、Selenium、Cypress、Puppeteer 四大主流浏览器自动化框架，团队沿用现有测试栈即可接入，不需要为视觉回归单独换一套工具链。
- 静态页面与组件级快照双路径：既支持传入 URL 列表做整页截图对比（crawl 模式），也支持接入 Storybook 做组件级视觉快照，覆盖“整页”与“组件”两种验证粒度。
- 多视口/多浏览器矩阵配置：
.smartui.json一份配置即可声明多组分辨率（含移动端视口）与多个浏览器引擎（Chrome/Firefox/Safari/Edge），一次运行覆盖响应式布局的多种呈现。 - 基线审批工作流讲解完整：从首次运行建立基线、后续运行自动对比差异、到在 SmartUI 控制台人工审批/驳回差异并将通过项设为新基线，形成完整闭环，而非只给“截图对比”这一步。
- 反模式对照表：把常见问题（未配置视口、未等待页面渲染完成、逐页截图噪音过多、跳过审批环节直接采信差异）与推荐做法并列说明原因。
- 深度 Playbook：配套参考文档共 664 行，覆盖 CLI 安装与项目结构、静态 URL 与 Storybook 两种测试模式、CI/CD 集成（GitHub Actions）、调试排错与最佳实践清单，SKILL.md + 参考文档合计约 23 KB。
- 纯参考文档形态：子目录仅含 SKILL.md 与一份 Markdown 参考文档，不含任何可执行脚本。
3. 适用场景
所属分类：工程效率与代码质量
已有 Playwright/Selenium/Cypress/Puppeteer 测试基础、想在功能测试之外补上“UI 有没有意外变样”这道视觉回归检查的前端与全栈开发者、QA 工程师；尤其适合组件库/设计系统迭代频繁、担心样式改动误伤既有页面的团队。需要注册 TestMu AI 账号获取 Project Token 才能使用完整的基线存储与审批流程。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。SKILL.md 采用标准 Agent Skills 格式，仓库 README 给出配套的官方安装工具。
- Codex：❓ 未验证——仓库 README 列出的受支持助手为 “Claude Code, GitHub Copilot, Cursor, Gemini CLI”，未点名 Codex。
- OpenClaw：❓ 未验证——已抓取材料未提及。
- Hermes Agent：❓ 未验证——已抓取材料未提及。
5. 推荐理由
视觉回归测试（截图/像素级差异对比）是功能测试之外容易被忽略的一环，本技能把它讲成一套框架无关、可直接套用的完整流程——从多视口配置、静态页面/Storybook 组件两种覆盖路径，到基线审批闭环与 CI 集成，附反模式对照表帮团队避免“截图噪音过多”“跳过审批直接采信差异”等常见坑；子目录不含任何脚本，安全面干净。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | TestMu AI（原 LambdaTest）是该领域公认的一线测试云平台：累计融资 1.08 亿美元（8 轮，最近一轮 2024 年 Avataar Venture Partners 领投的 3800 万美元 C 轮），18,000+ 企业客户（含 Microsoft、OpenAI、Nvidia），Forbes 2026-01-12 有专文报道；且 SmartUI 是该公司自研的第一方产品。合集仓库整体 352 stars 属整个合集，不代表本技能自身热度，未查到本技能自身的独立第三方评价 |
| 可用性 | 8 | CLI 一条 npm install @lambdatest/smartui-cli 即可接入，配置文件与用法示例完整；使用云端基线存储与审批看板前需先注册 TestMu AI 账号并取得 Project Token；文档含 CLI 安装、双测试模式、CI 集成、调试排错等完整专题；子目录最后提交约 5.7 个月前，未见归档或功能性问题 |
| 安全性 | 9 | 子目录不含任何脚本或可执行文件，仅 SKILL.md 与一份 Markdown 参考文档；逐份扫描未见可疑指令或隐藏外发；凭据（PROJECT_TOKEN/LT_USERNAME/LT_ACCESS_KEY）均以环境变量占位符呈现，无硬编码；截图上传至 SmartUI 云端是该工具的核心功能本身、非隐蔽外发；License（MIT）明确 |
安全检查清单：① Shell 命令——无，不含 scripts/；② 联网外发——截图上传至用户自有 TestMu AI 项目是产品核心功能，用途透明非隐蔽；③ 凭据——PROJECT_TOKEN/LT_USERNAME/LT_ACCESS_KEY 均为环境变量占位符，无硬编码；④ 可疑指令——未发现；⑤ 作者信誉——TestMu AI，融资/客户量/媒体报道均可查证，良好；⑥ License——MIT，明确；⑦ 最近维护——约 2026-02-23，约 5.7 个月前，未见归档。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| Percy（BrowserStack 旗下） | 老牌独立视觉回归 SaaS，同样支持多框架接入与云端基线审批 | 定位高度相似的商业竞品，未见对应 Agent Skill 化的官方发布；本技能的优势在于原生嵌入 AI 编码助手工作流，由 Agent 直接生成配置与调用代码 |
| Chromatic（Storybook 官方） | 专注 Storybook 组件级视觉测试，与 Storybook 生态绑定最深 | Chromatic 只覆盖组件级快照，不做整页 URL 级回归；本技能框架无关且同时支持整页 URL 与 Storybook 组件两种模式，覆盖面更宽 |
Playwright 内置 toHaveScreenshot |
Playwright 自带的像素对比断言，无需额外账号 | 完全本地化、零外部依赖，但基线管理需自行用 Git 存储图片、缺少审批看板与跨浏览器矩阵；本技能提供托管式基线存储与人工审批工作流，适合团队协作场景 |
核心差异化在于“框架无关 + 双覆盖路径（整页/组件）+ 完整审批闭环”三者兼备：多数替代方案要么绑定单一测试框架（Playwright 内置方案），要么只覆盖组件级（Chromatic），本技能把配置生成与调用代码都交给 AI 助手完成，降低了接入视觉回归测试的门槛。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；LambdaTest/agent-skills 仓库整体在 GitHub 上有真实的多贡献者协作记录，其中一条已关闭的历史提交记录显示维护团队曾主动修复过 SmartUI CLI 默认安装版本的问题。
9. 其他补充
- 支持语言：JavaScript、TypeScript、Java（Selenium 场景下的截图触发调用）。
- Storybook 集成一节给出了
npx smartui storybook <url>的独立命令，可在不接入完整 E2E 测试的情况下单独跑组件级视觉回归。 - 反模式对照表明确指出“逐页截图”会造成噪音，建议聚焦关键页面/组件，对控制视觉回归的维护成本有实用参考价值。
10. 安装使用方式
方式一：官方 CLI（仓库推荐）
git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill smartui-skill方式二：手动复制（本技能不含任何脚本，直接复制目录即可）
git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/smartui-skill ~/.claude/skills/安装后注意事项：复制到位后无需重启；但要跑通完整的基线存储与审批看板，需先在 SmartUI 控制台创建项目并取得 PROJECT_TOKEN（若结合 Selenium/Playwright 云端跨浏览器执行，另需 LT_USERNAME/LT_ACCESS_KEY），并设为环境变量。Agent 会在识别到 “SmartUI”、“visual regression”、“screenshot comparison” 等触发词时自动读取本技能内容。
11. 注意事项
- 本技能面向“已确定要做视觉回归测试”的团队；示例中的基线审批、多视口矩阵均为 SmartUI 平台内置能力，脱离该平台无法直接复用配置。
- 核心的基线存储与审批看板依赖 TestMu AI 云端服务，是否有免费额度、额度上限等计费细节未在已抓取材料中验证，需自行查阅官方定价页确认。
- 内容聚焦 SmartUI 本身的配置与调用方式，不涉及“要不要引入视觉回归测试”或“视觉回归 vs 功能测试优先级”等选型建议。
- 子目录最后提交约在 2026-02-23，约 5.7 个月前，暂未发现功能性问题，但关注长期维护节奏的团队可留意后续更新频率。