1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | puppeteer-skill-lambdatest-agent-skills |
| 作者/维护者 | TestMu AI（原 LambdaTest） |
| 来源链接 | https://github.com/LambdaTest/agent-skills/tree/main/puppeteer-skill |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 352（数据来自 GitHub API；为整个合集仓库总量，不代表本技能自身热度） |
| Forks | 69（数据来自 GitHub API，同为合集整体口径） |
| 最新版本 | 1.0（SKILL.md front matter 自述，仓库未发布正式 Release） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
为 Puppeteer（Google 出品、基于 Chrome DevTools Protocol 的浏览器自动化库）生成 JavaScript/TypeScript 脚本的技能，覆盖浏览器自动化、网页抓取与 PDF 生成三类核心用途。
- 核心模式速查：基础脚本骨架、四类等待策略（选择器/导航/自定义条件/网络响应）、截图与 PDF 生成、请求拦截与 API Mock 均给出可直接套用的示例。
- 深度 Playbook（12 个专题）：
reference/playbook.md覆盖生产环境配置（含 Jest 集成）、完整 Page Object Model（BasePage/LoginPage/DashboardPage）、网络拦截与 Mock、四类等待策略、截图/PDF/视频录制、认证与 Cookie 会话保存恢复、iFrame/对话框/文件上传下载、性能指标（Web Vitals、Lighthouse、代码覆盖率）、无障碍测试（@axe-core/puppeteer集成）、CI/CD（GitHub Actions、Docker）、11 项调试排错对照表与 13 条最佳实践清单；另有reference/advanced-patterns.md补充速查示例、reference/cloud-integration.md补充云端并行配置。SKILL.md + 三份参考文档合计约 22.6 KB。 - 无障碍与性能测试代码示例：除功能测试外，还给出 axe-core 无障碍扫描与 Core Web Vitals/Lighthouse 性能采集的完整代码示例。
- 纯参考文档形态：子目录仅含 SKILL.md 与三份 Markdown 参考文档，不含任何可执行脚本。
- 可选云端执行：正文附一段 TestMu AI（原 LambdaTest）云端浏览器连接示例（通过 CDP WebSocket），经环境变量
LT_USERNAME/LT_ACCESS_KEY接入，属可选增强，本地生成与运行不依赖任何第三方账号。
3. 适用场景
所属分类：工程效率与代码质量
需要用 Puppeteer 做浏览器自动化、网页抓取或 PDF 生成的团队，尤其是希望覆盖无障碍测试与性能指标采集等进阶场景、又不想从零手写 Page Object 与网络拦截样板代码的初中级开发者；不强制依赖 TestMu AI 云端服务，纯本地可用。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。SKILL.md 采用标准 Agent Skills 格式，仓库 README 给出配套的官方安装工具。
- Codex：❓ 未验证——仓库 README 列出的受支持助手为 “Claude Code, GitHub Copilot, Cursor, Gemini CLI”，未点名 Codex。
- OpenClaw：❓ 未验证——已抓取材料未提及。
- Hermes Agent：❓ 未验证——已抓取材料未提及。
5. 推荐理由
一份把 Puppeteer 从基础脚本、等待策略、网络拦截讲到无障碍测试、性能指标采集与 CI/CD 集成的技能，12 个专题覆盖生产环境配置到调试排错的完整链路；核心路径零付费依赖、子目录不含任何脚本，安全面干净。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | TestMu AI（原 LambdaTest）是该领域公认的一线测试云平台：累计融资 1.08 亿美元（8 轮，最近一轮 2024 年 Avataar Venture Partners 领投的 3800 万美元 C 轮），18,000+ 企业客户（含 Microsoft、OpenAI、Nvidia），Forbes 2026-01-12 有专文报道。合集仓库整体 352 stars 属整个合集，不代表本技能自身独立热度，未查到与本技能直接相关的独立第三方评价 |
| 可用性 | 8 | 核心功能零配置、零付费依赖，只需项目已引入或计划引入 Puppeteer 即复制即用；文档完整含 12 个专题深度示例（约 22.6 KB），覆盖生产配置到调试排错；子目录最后提交约 2026-02-23（约 5.7 个月前），未见归档或功能性问题 |
| 安全性 | 9 | 子目录不含任何脚本或可执行文件，仅 SKILL.md 与三份 Markdown 参考文档；逐份扫描未见可疑指令或隐藏外发；云端功能需 LT_USERNAME/LT_ACCESS_KEY 环境变量，存储方式清晰透明，本地功能不涉及任何凭据；License（MIT）明确 |
安全检查清单：① Shell 命令——无，不含 scripts/；② 联网外发——本地路径无任何外发，云端路径仅连接用户主动配置的 TestMu AI 官方 CDP 端点；③ 凭据——云端功能需 LT_USERNAME/LT_ACCESS_KEY 环境变量（非硬编码），本地功能不涉及任何凭据；④ 可疑指令——未发现；⑤ 作者信誉——TestMu AI，融资/客户量/媒体报道均可查证，良好；⑥ License——MIT，明确；⑦ 最近维护——约 2026-02-23，约 5.7 个月前，所属仓库整体未被归档。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| playwright-skill-lambdatest-agent-skills（同仓库） | 微软出品的现代浏览器自动化框架，自动等待机制内置 | Playwright 走独立浏览器协议、跨浏览器（含 Firefox/WebKit）支持更完整；Puppeteer 专注 Chrome/Chromium，API 更贴近 Chrome DevTools Protocol 原语，适合需要精细控制 CDP 层行为（如自定义 tracing、覆盖率采集）的场景 |
| webdriverio-skill-lambdatest-agent-skills（同仓库） | 基于标准 WebDriver 协议的现代化 Node.js 测试框架 | WebdriverIO 走 W3C WebDriver 标准协议、跨浏览器兼容性成熟度高；Puppeteer 走 Chrome DevTools Protocol，网络拦截、性能采集、PDF 生成等 Chrome 原生能力更直接 |
| selenium-skill-lambdatest-agent-skills（同仓库） | 最早的浏览器自动化标准实现 | Selenium 是 WebDriver 协议的原始实现、跨浏览器覆盖最广；Puppeteer 仅覆盖 Chrome/Chromium 系，换取更轻量的 API 与更强的 Chrome 原生特性（如 PDF 生成、Coverage API） |
核心差异化在“Chrome 原生能力的深度覆盖”：Puppeteer 基于 CDP 直连 Chrome，本技能据此额外给出无障碍测试（axe-core）、性能指标（Web Vitals/Lighthouse/代码覆盖率）与 PDF 生成的完整实现，比仅聚焦基础用例生成的同类技能覆盖面更完整。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；LambdaTest/agent-skills 仓库整体在 GitHub 上有真实的多贡献者协作记录。
9. 其他补充
- Deep Patterns 表格里的 12 个专题均标注了对应小节标题，方便 Agent 按需定位到具体章节而非整份读入。
- 无障碍测试专题（§9）依赖
@axe-core/puppeteer，需按需自行安装该依赖包。
10. 安装使用方式
方式一：官方 CLI（仓库推荐）
git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill puppeteer-skill方式二：手动复制（本技能不含任何脚本，直接复制目录即可）
git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/puppeteer-skill ~/.claude/skills/安装后注意事项：复制到位后无需重启、无需注册任何账号，Agent 会在识别到 “Puppeteer”、“headless Chrome”、“page.goto”、“scrape”、“PDF generation” 等触发词时自动读取本技能内容。
11. 注意事项
- 云端跨浏览器执行需要 TestMu AI（原 LambdaTest）账号与访问密钥，纯本地测试不受此限制。
- 子目录最后提交约在 2026-02-23，约 5.7 个月前，暂未发现功能性问题，但关注长期维护节奏的团队可留意后续更新频率。
- 仅支持 Chrome/Chromium 系浏览器，需要跨浏览器（Firefox/Safari/WebKit）覆盖的团队应改选 Playwright 或 Selenium/WebdriverIO 技能。