1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | e2e-testing-patterns(合集子技能,完整标识 e2e-testing-patterns-wshobson-agents) | GitHub |
| 作者/维护者 | Seth Hobson(wshobson/agents 仓库维护者,个人开发者) | GitHub API |
| 来源链接 | https://github.com/wshobson/agents/tree/main/plugins/developer-essentials/skills/e2e-testing-patterns | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars/Forks | 合集仓库整体 38,648 / 4,122(不代表本技能自身热度) | GitHub API |
| 最新版本 | 所属 developer-essentials 插件 v1.0.4 | 仓库 plugin.json |
| 安装方式 | 见第 10 章 | — |
2. 功能介绍与亮点
E2E Testing Patterns 是一份工具无关(同时覆盖 Playwright 与 Cypress)的端到端测试方法论指南:
- 测试金字塔与取舍:明确“什么该用 E2E 测”(关键用户旅程、跨浏览器兼容、真实 API 集成)与“什么不该用 E2E 测”(单元逻辑、API 契约、边界情况),避免测试套件臃肿。
- 稳定选择器策略:给出
data-testid/getByRole等稳定选择器与脆弱 CSS 选择器的正误对照代码。 - Flaky 测试排障:Playwright 的 headed 模式、debug 模式、trace viewer、
test.step分步报告等具体排障手法。 - 常见陷阱清单:慢测试、过度测试、耦合测试、糟糕选择器、无清理等七类反模式及对策。
- 正文(4KB)为导航层,
references/details.md(10.3KB)承载 Cypress 专项模式、E2E 检查清单等深度内容。
3. 适用场景
所属分类:工程效率与代码质量。
适合负责实现端到端测试自动化的前端/全栈工程师、排查不稳定测试的开发者、以及需要为团队建立 E2E 测试规范的技术负责人。同时使用 Playwright 与 Cypress 的团队可直接复用其工具无关的选择器与排障策略。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 仓库为 Claude Code 插件市场源码(.claude-plugin/plugin.json),SKILL.md 为标准 Agent Skills 格式 |
| Codex | ✅ 支持 | README 提供 npx codex-marketplace add 原生安装路径,仓库同时维护 Codex 专属清单 |
| OpenClaw | 未验证 | 已抓取材料(README、提交记录)提及 Cursor/OpenCode/Gemini/Copilot 多运行时适配,未提及 OpenClaw |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes Agent 支持 |
5. 推荐理由
E2E 测试最容易写成又慢又脆弱的样子,这份技能把“该测什么、不该测什么”与“选择器怎么选、测试挂了怎么查”讲清楚,覆盖 Playwright 与 Cypress 两大主流框架,装上即可用,无需额外配置或密钥。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 第三方安装工具 Skills.sh 显示该技能单独安装量约 2.07 万次,在 wshobson/agents 全部 180 个子技能中排名第 12 位;已被 Smithery、LobeHub(两个独立收录)、SkillsMP 等至少 4 家独立技能市场收录分发,但暂未发现具名用户评分或评价 |
| 可用性 | 9 | 导航层+详情层结构完整,含大量可运行代码示例(TypeScript 选择器对照、Playwright 调试命令);工具无关设计覆盖两大主流框架;无付费依赖,一条命令即可安装;对应文件最近一次实质修订为 2026-05-22 |
| 安全性 | 9 | 见下方安全检查清单 |
安全检查清单:① shell 命令/权限:正文含 Playwright CLI 命令示例,均为供用户参考的说明性代码块,非技能自动执行 ② 联网外发:无 ③ API key/凭据:不需要 ④ 可疑指令:未发现 ⑤ 作者信誉:个人开发者,仓库内容公开可审计、持续维护,未见刷星或造假迹象 ⑥ License:MIT,明确 ⑦ 维护时间:仓库整体活跃(最近推送 2026-08-05),本文件自身修订于 2026-05-22
综合评分 = (5+9+9)/3 ≈ 7.67
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| playwright-skill(lackeyjb) | 让 Claude 现场编写 Playwright 脚本测试浏览器功能,比常驻 MCP 更省上下文 | 定位为执行工具,帮 Claude 现场写测试脚本;本技能是工具无关的测试方法论,额外覆盖 Cypress 与测试金字塔取舍原则 |
| playwright-skill(testdino-hq) | 生产验证的 Playwright 测试模式与 CI/迁移指南库 | 仅聚焦 Playwright 单一工具的模式与 CI 配置;本技能同时覆盖两大框架的通用原则,且专门收录 flaky 测试排障手法 |
| playwright-e2e-testing(fugazi) | 把 Playwright 最佳实践写成规则清单,减少 AI 生成脆弱端到端测试 | 同为 Playwright 专项规则清单;本技能定位更基础通用,从“什么该测/不该测”的取舍原则讲起,并不限定单一工具 |
8. 用户评价
该技能已被 Smithery、LobeHub(两个独立条目)、SkillsMP 等第三方技能市场收录展示,但尚未发现具名用户评价或评分。
9. 其他补充
所属仓库同一份内容会转译为 Claude Code、Codex CLI、Cursor、OpenCode、Gemini CLI、GitHub Copilot 六种运行时格式。本技能归属 developer-essentials 插件,与 Git 高级工作流、SQL 优化、代码评审等其余 10 个开发技能同插件打包。
10. 安装使用方式
- Claude Code(官方插件市场,按插件粒度安装):
该命令会同时装入 developer-essentials 插件下其余 10 个开发技能;本技能会在涉及 E2E 测试、Playwright/Cypress、排查不稳定测试等任务时按描述自动触发。/plugin marketplace add wshobson/agents /plugin install developer-essentials - Codex CLI(原生市场安装):
npx codex-marketplace add wshobson/agents - 仅安装本技能(社区工具 Skills.sh,不含整个插件包):
npx skills add https://github.com/wshobson/agents --skill e2e-testing-patterns - 安装后无需重启 agent,SKILL.md 内容会在任务描述匹配时自动加载,无需手动调用。
11. 注意事项
- 官方渠道按插件粒度安装,会连带装入其余 10 个开发技能;只想要本技能可改用 Skills.sh 单独安装。
- 作者为个人开发者;正文示例以 TypeScript/Playwright/Cypress 生态为主,其他语言绑定的测试框架需自行迁移思路。
- 详细的 Cypress 专项模式与完整检查清单在
references/details.md,需 agent 按需加载才能读到。