1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | react19-test-patterns-github-awesome-copilot |
| 作者/维护者 | github/awesome-copilot(社区共建 Agent Skills 合集仓库,本技能由贡献者 Saravanan Rajaraman 提交并经仓库维护流程合并) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/react19-test-patterns |
| 许可证 | MIT(GitHub API 数据) |
| GitHub Stars | 合集仓库整体 39,620(GitHub API);属整个合集,不代表本技能自身热度 |
| Forks | 合集仓库整体 5,045,同上,不代表本技能个体热度 |
| 最新版本 | 不单独发版本号,随合集仓库滚动更新(本技能所在 PR 于 2026-08 曾被仓库维护者统一修复过代码块格式问题) |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill react19-test-patterns,见第 9 章 |
2. 功能介绍与亮点
把 React 19 移除旧版 react-dom/test-utils 后,测试文件必然出现的一整套失败,拆解成固定顺序的修复清单。
- 明确给出必须按顺序修的 6 步优先级:
act导入修复 →Simulate替换为fireEvent→ 清理其余react-dom/test-utils残留导入 → 核实 StrictMode 下的调用次数 → 补齐遗留的act异步包裹警告 → 统一自定义 render 工具函数,强调每一步解锁下一步、顺序不可打乱 - 给出
react-dom/test-utils全量 API 对照表(act/Simulate/renderIntoDocument/findRenderedDOMComponentWithTag等 8 项),逐项标注 React 19 下的替代写法 - 专门提醒 React 19 的 StrictMode 不再对
useEffect做双调用,要求“先跑测试读实际报错次数,再改断言”,而不是凭经验猜测该写 1 还是 2;并区分渲染阶段调用(仍保持双调用)与副作用调用(不再双调用)两种不同情形,避免一刀切改错 - 全文只给带注释的 before/after 代码对照,无需任何额外配置或依赖安装,复制即可对照修改
3. 适用场景
所属分类:工程效率与代码质量。适合正在把代码库从 React 18 升级到 React 19、CI 测试套件大量报错的前端团队;尤其适合测试文件里还保留 react-dom/test-utils 旧写法(Simulate、renderIntoDocument 等)、靠人工逐个排查耗时费力的场景。典型触发时机:升级 React 大版本后测试套件红灯、或正在从 Enzyme/旧 test-utils 迁移到现代测试方式。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准单文件 SKILL.md,可直接放入 .claude/skills/ |
| Codex | ⚠️ 需适配 | 不会自动发现 ~/.codex/skills,需手动引用路径 |
| OpenClaw | ✅ 原生支持 | 按目录扫描探测子目录 SKILL.md |
| Hermes Agent | ✅ 原生支持 | 同样按路径扫描探测 SKILL.md |
5. 推荐理由
React 19 移除 react-dom/test-utils 是升级路上最容易让测试套件大面积变红的一步,本技能把修复顺序、API 对照表、StrictMode 计数陷阱全部整理成可直接套用的 before/after 代码,省去逐个报错去翻 React 官方迁移文档再试错的过程,内容零依赖、复制即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 第三方技能目录 skills.sh 收录并统计独立安装量约 1,200 次,近两月周安装量稳定无突刺(非刷量特征);合集仓库 stars 不计入本技能个体热度 |
| 可用性 | 9 | 纯 Markdown 参考内容,无需任何配置或依赖,复制 before/after 代码即可对照修改;仓库 2026-10-01 仍有提交,整体维护活跃,本技能所在内容 2026-08 曾被仓库维护者修复过格式问题 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:① 全文不包含任何需要执行的 shell 命令(唯一一条 npm test 命令是用户自行决定是否运行的诊断建议,非技能自动执行);② 不联网、不外发任何数据;③ 不要求任何 API key 或凭据;④ 全文无可疑指令或夹带推广内容,纯技术参考;⑤ 作者为长期活跃的真实 GitHub 账号(2013 年注册),非新建马甲,内容经 GitHub 官方合集仓库维护流程审核合并;⑥ License 明确(MIT);⑦ 仓库整体维护活跃,本技能所在内容近期曾被统一修复维护。
7. 跟同类 Skills 相比的优势
| 候选 | 核心定位 | 覆盖方式 |
|---|---|---|
| react19-test-patterns(本技能) | 专门修复 React 19 移除旧版 test-utils 后测试文件的失败 | 固定 6 步优先级 + 完整 API 对照表 + StrictMode 计数陷阱排查 |
| react18-enzyme-to-rtl(同仓库) | 把 Enzyme 测试整体改写为 React Testing Library | 覆盖的是测试框架层面的迁移(Enzyme→RTL),不处理 React 19 特有的 test-utils 移除问题 |
| React Doctor(millionco/react-doctor) | 确定性扫描 React 代码质量,CI 中拦截反模式 | 面向日常代码质量治理,不针对版本升级引发的测试失败做专门修复 |
三者分工不同:react18-enzyme-to-rtl 解决的是测试框架选型层面的迁移,React Doctor 管的是日常代码质量巡检,本技能专门针对“升级到 React 19 之后测试立刻报错”这一具体时间点的具体问题,覆盖面更窄但指向性更强。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 技能目录收录了其独立安装量统计与三项第三方安全审计结果(Gen Agent Trust Hub、Socket、Snyk 均为 PASS),但未见评价区内容。
9. 安装使用方式
- 一条命令安装(推荐):
npx skills add https://github.com/github/awesome-copilot --skill react19-test-patterns - 手动安装:从 GitHub 仓库
skills/react19-test-patterns/目录复制SKILL.md到所用 Agent 的 skills 目录(如 Claude Code 的.claude/skills/react19-test-patterns/) - 安装后无需重启;触发方式是在对话中提及“React 19 测试失败”“act 导入报错”“Simulate 已移除”“StrictMode 调用次数变化”等意图;使用前无需任何额外配置
10. 注意事项
- 内容针对的是从 React 18 升级到 React 19 这一特定场景,若项目仍停留在 React 18 或更早版本则不适用
- StrictMode 调用次数修复要求先实际运行测试读取报错里的真实次数再改断言,技能本身不能替用户跑测试
- 不覆盖 Enzyme 测试的整体重写(该需求见同仓库 react18-enzyme-to-rtl),也不覆盖日常代码质量巡检(见 React Doctor)