1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | react18-lifecycle-patterns-github-awesome-copilot |
| 项目自述名称 | React 18 Lifecycle Patterns |
| 作者/维护者 | github/awesome-copilot(社区共建 Agent Skills 合集仓库,本技能由贡献者 Saravanan Rajaraman 于 2026-04-09 提交并经仓库维护流程合并) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/react18-lifecycle-patterns |
| 许可证 | MIT(GitHub API 数据) |
| GitHub Stars | 合集仓库整体 40,041(GitHub API);属整个合集,不代表本技能自身热度 |
| Forks | 合集仓库整体 5,126,同上 |
| 最新版本 | 不单独发版本号,随合集仓库滚动更新 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill react18-lifecycle-patterns,见第 10 章 |
2. 功能介绍与亮点
React 18.3.1 起,类组件的 componentWillMount、componentWillReceiveProps、componentWillUpdate 会触发警告,React 19 中彻底移除。本技能给出这三个方法的迁移做法。
- 先判语义再迁移:主文件用三张决策表,按“这个方法实际在做什么”路由到正确改法,而不是按方法名套模板。例如
componentWillMount里设初始状态要挪进constructor,跑副作用要挪进componentDidMount componentWillReceiveProps二选一:异步副作用走componentDidUpdate,纯状态推导才用getDerivedStateFromProps;拿不准时默认componentDidUpdate,并在参考文件末尾列出getDerivedStateFromProps的常见陷阱componentWillUpdate对应拆分:读 DOM(滚动、尺寸)用getSnapshotBeforeUpdate配componentDidUpdate,取消请求等副作用用带 prevProps 比较的componentDidUpdateUNSAFE_前缀只是权宜:明确告诫加前缀只能压掉警告,不解决并发模式问题,也挡不住 React 19 的移除,并给出临时标注 TODO 的写法- 三份参考文件:
componentWillMount.md、componentWillReceiveProps.md、componentWillUpdate.md各含多个场景的完整前后对照代码,含异步请求取消的写法
3. 适用场景
所属分类:工程效率与代码质量。适合升级到 React 18.3.1 / 19、代码库里仍有大量类组件的前端团队,以及被 UNSAFE_ 生命周期警告刷屏、想系统清理而非逐条查文档的开发者。项目已全面使用函数组件与 Hooks 时不适用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准 SKILL.md 加 references/ 子目录,放入 .claude/skills/ 即可 |
| Codex | ⚠️ 需适配 | Codex 不会自动发现 ~/.codex/skills,需手动引用路径 |
| OpenClaw | ✅ 原生支持 | 按目录扫描探测子目录 SKILL.md |
| Hermes Agent | ✅ 原生支持 | 同样按路径扫描探测 SKILL.md |
5. 推荐理由
生命周期迁移最容易出错的地方是“归错类”:把该放进 componentDidUpdate 的异步逻辑塞进 getDerivedStateFromProps,会引入难查的状态覆盖问题。本技能把分类判据前置成决策表,并配齐前后对照代码,Agent 在批量改类组件时不必凭记忆猜模式。纯文档内容,零配置即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | skills.sh 记录独立安装量 743 次,首次收录于 2026-04-09;合集仓库 stars 不计入本技能个体热度 |
| 可用性 | 7 | 主文件加三份带完整前后对照的参考文档(合计约 13.6KB),无需配置;技能自 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-lifecycle-patterns(本技能) | 三个不安全生命周期方法的迁移决策与前后对照 | 按语义分类路由,覆盖 getSnapshotBeforeUpdate 与 getDerivedStateFromProps 的取舍,面向 React 18.3.1 / 19 |
| react18-legacy-context(同仓库) | 旧 context API 迁移到 createContext |
处理的是 contextTypes 的跨文件迁移,不涉及生命周期方法 |
| react18-string-refs(同仓库) | 字符串 ref 迁移到 createRef |
只处理 ref 写法,不涉及生命周期 |
| React 官方文档的 “You Probably Don’t Need Derived State” 等文章 | 解释为何避免派生状态 | 讲原理与反模式,不提供“每种旧写法对应怎么改”的逐项映射 |
本技能的差异化在于“按方法实际用途分流”的决策表:覆盖范围限于三个生命周期方法,但指向明确,适合批量改写类组件。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 提供其独立安装量(743)与三项第三方安全审计结果(均为 PASS)。
9. 其他补充
同一贡献者在合集仓库中提交了一组 React 18/19 升级系列技能(依赖兼容性、批处理、旧 context、字符串 refs、Enzyme 到 RTL 等),可按升级阶段分别取用。
10. 安装使用方式
- 一条命令安装(推荐):
npx skills add https://github.com/github/awesome-copilot --skill react18-lifecycle-patterns - 手动安装:把仓库
skills/react18-lifecycle-patterns/目录(含SKILL.md与references/)整体复制到所用 Agent 的 skills 目录,例如 Claude Code 的.claude/skills/react18-lifecycle-patterns/ - 安装后无需重启;在对话中提到“迁移 componentWillReceiveProps”“修复 UNSAFE_ 生命周期警告”“类组件升级 React 18”等意图即可触发
11. 注意事项
- 内容针对类组件的三个不安全生命周期方法,不涉及其他 React 18/19 破坏性变更
- 技能不会代为运行应用或测试,迁移后的行为需自行验证;涉及
getDerivedStateFromProps的改动尤其要核对是否存在状态覆盖 - 技能自 2026-04-09 后未更新,React 19 稳定后的细节变化需自行对照官方升级指南