1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | react18-enzyme-to-rtl-github-awesome-copilot |
| 项目自述名称 | React 18 Enzyme → RTL Migration |
| 作者/维护者 | github/awesome-copilot(社区共建 Agent Skills 合集仓库,本技能由贡献者 Saravanan Rajaraman 于 2026-04-09 提交并经仓库维护流程合并) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/react18-enzyme-to-rtl |
| 许可证 | MIT(GitHub API 数据) |
| GitHub Stars | 合集仓库整体 40,038(GitHub API);属整个合集,不代表本技能自身热度 |
| Forks | 合集仓库整体 5,126,同上 |
| 最新版本 | 不单独发版本号,随合集仓库滚动更新 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill react18-enzyme-to-rtl,见第 10 章 |
2. 功能介绍与亮点
React 18 没有 Enzyme 适配器,升级时所有 Enzyme 测试都必须改写成 React Testing Library(RTL)。本技能给出这次改写的固定做法。
- 先讲思路转变:Enzyme 测实现(
wrapper.state()、wrapper.instance()),RTL 测行为(用户看到什么、能做什么)。明确告诫不要 1:1 翻译 API,否则写出脆弱的 RTL 测试;读内部 state 的断言要改成断言界面上的可见结果 - 统一改写模板:render(替代 shallow/mount)→ query(替代
wrapper.find())→ interact(替代simulate())→ 对可见输出断言 - 查询优先级清单:
getByRole→getByLabelText→getByPlaceholderText→getByText→getByDisplayValue→getByAltText→getByTitle→getByTestId(最后手段) - Provider 包装写法:把 Enzyme 里
mount套 Apollo、主题等 Provider 的写法对应到 RTL - 两份参考文件:
enzyme-api-map.md覆盖 configure、渲染、查询、交互、prop/state 断言、实例方法、存在性检查、多元素的前后对照;async-patterns.md覆盖wrapper.update()替换、异步交互、加载态、Apollo MockedProvider、错误态、act()手动控制、waitFor/findBy选用与常见迁移错误
3. 适用场景
所属分类:工程效率与代码质量。适合把 React 16/17 项目升级到 React 18、测试套件里还有大量 import ... from 'enzyme' 的前端团队;也适合已决定放弃 Enzyme、需要成体系重写测试而非逐条查文档的开发者。若项目没有使用 Enzyme,则不适用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准 SKILL.md 加 references/ 子目录,放入 .claude/skills/ 即可 |
| Codex | ⚠️ 需适配 | Codex 不会自动发现 ~/.codex/skills,需手动引用路径 |
| OpenClaw | ✅ 原生支持 | 按目录扫描探测子目录 SKILL.md |
| Hermes Agent | ✅ 原生支持 | 同样按路径扫描探测 SKILL.md |
5. 推荐理由
Enzyme 迁移是 React 18 升级里最耗人工的一块:既要换 API,更要换测试思路。本技能把“哪些 Enzyme 断言没有 RTL 对应物、该改成断言什么”讲得很直接,并附带异步与 Apollo 场景的现成写法,让 Agent 改写时不再逐行机械翻译,产出更稳的测试。纯文档内容,零配置即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | skills.sh 记录独立安装量 739 次,首次收录于 2026-04-09;合集仓库 stars 不计入本技能个体热度 |
| 可用性 | 7 | 主文件加两份带完整前后对照的参考文档,无需配置;技能自 2026-04-09 提交后未再更新,距今约 6 个月 |
| 安全性 | 9 | 见下方检查清单 |
综合分为三项均值。安全检查清单:① 全文是测试改写参考,不要求执行任何 shell 命令;② 不联网、不外发数据;③ 不要求任何 API key 或凭据;④ SKILL.md 与两份参考文件通读,无可疑指令或夹带推广内容;⑤ 托管于 GitHub 官方组织下的合集仓库,经维护流程审核合并;⑥ License 明确(MIT);⑦ 仓库整体持续维护,最近一次推送为 2026-10-15。skills.sh 上 Gen Agent Trust Hub、Socket、Snyk 三项第三方安全审计均为 PASS。
7. 跟同类 Skills 相比的优势
| 候选 | 核心定位 | 差异 |
|---|---|---|
| react18-enzyme-to-rtl(本技能) | 把 Enzyme 测试整体改写为 RTL | 带思路转变说明、API 全对照与异步/Apollo 专章,面向 React 18 升级 |
| react19-test-patterns(同仓库) | 修复 React 19 移除 react-dom/test-utils 后的测试失败 |
处理的是 React 19 的 test-utils 问题,不涉及 Enzyme 到 RTL 的框架迁移 |
| 直接阅读 RTL 官方文档自行迁移 | 通用的 RTL 使用说明 | 讲 RTL 怎么用,但不提供“Enzyme 每个 API 对应怎么改”的逐项映射,需要自己归纳 |
本技能的差异化在于“针对 Enzyme 存量测试的迁移映射”:覆盖面比通用文档窄,但指向性强,适合批量改写。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 提供其独立安装量(739)与三项第三方安全审计结果(均为 PASS)。
9. 其他补充
同一贡献者在合集仓库中提交了一组 React 18/19 升级系列技能(依赖兼容性、批处理、生命周期、字符串 refs、旧 context 等),可按升级阶段分别取用。
10. 安装使用方式
- 一条命令安装(推荐):
npx skills add https://github.com/github/awesome-copilot --skill react18-enzyme-to-rtl - 手动安装:把仓库
skills/react18-enzyme-to-rtl/目录(含SKILL.md与references/)整体复制到所用 Agent 的 skills 目录,例如 Claude Code 的.claude/skills/react18-enzyme-to-rtl/ - 安装后无需重启;在对话中提到“重写 Enzyme 测试”“shallow/mount 迁移 RTL”“React 18 升级测试”等意图即可触发
11. 注意事项
- 内容针对 React 18 升级场景下的 Enzyme 迁移,项目未使用 Enzyme 时无用
- 依赖项目已安装
@testing-library/react、@testing-library/user-event与@testing-library/jest-dom,技能本身不负责安装 - 技能不会代为运行测试,改写后的断言仍需自行执行验证;读取组件内部 state 的测试需要改写成界面行为断言,不存在机械替换