1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | react18-legacy-context-github-awesome-copilot |
| 项目自述名称 | React 18 Legacy Context Migration |
| 作者/维护者 | github/awesome-copilot(社区共建 Agent Skills 合集仓库,本技能由贡献者 Saravanan Rajaraman 于 2026-04-09 提交并经仓库维护流程合并) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/react18-legacy-context |
| 许可证 | MIT(GitHub API 数据) |
| GitHub Stars | 合集仓库整体 40,065(GitHub API);属整个合集,不代表本技能自身热度 |
| Forks | 合集仓库整体 5,129,同上 |
| 最新版本 | 不单独发版本号,随合集仓库滚动更新 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill react18-legacy-context,见第 10 章 |
2. 功能介绍与亮点
React 的旧版 context API(contextTypes、childContextTypes、getChildContext)自 16.3 起弃用,18.3.1 会告警,React 19 中已移除。本技能给出迁移到 createContext 的完整做法。
- 按跨文件迁移来设计:主文件开宗明义,context 迁移必须同时改“新建 context 文件、provider、所有 consumer”,漏改任何一个 consumer 都会读到
undefined;并给出固定的六步顺序 - 先扫描再动手:附三条
grep命令,分别找出所有 provider、所有 consumer,以及需要人工判断新旧用法的this.context引用 - 三份参考文件(合计约 14KB):
single-context.md:以 ThemeContext 为例,给出 provider、类组件 consumer(static contextType)、函数组件 consumer(useContext)的前后对照与验证清单multi-context.md:多个旧 context 并存时逐个迁移,不要“先改完全部 provider 再改 consumer”;单个 provider 导出多个值时拆成独立 context;类组件需要多个 context 时,给出Consumer嵌套和改写成函数组件两种做法context-file-template.md:新 context 模块的标准模板(默认值、displayName、自定义 hook)和目录约定
- 区分新旧写法:反复提醒
contextType(单数,现代 API)与contextTypes(复数,旧 API)不是一回事,并说明 React 19 可写<Context value>、18.3.1 仍用<Context.Provider>
3. 适用场景
所属分类:工程效率与代码质量。适合升级到 React 18.3.1 / 19、代码库里仍有旧 context 的前端团队,尤其是 provider 与 consumer 分散在许多文件、容易漏改的大型类组件项目。代码库只用 createContext 或 Hooks 时不适用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准 SKILL.md 加 references/ 子目录,放入 .claude/skills/ 即可 |
| Codex | ⚠️ 需适配 | Codex 不会自动发现 ~/.codex/skills,需手动引用路径 |
| OpenClaw | ✅ 原生支持 | 按目录扫描探测子目录 SKILL.md |
| Hermes Agent | ✅ 原生支持 | 同样按路径扫描探测 SKILL.md |
5. 推荐理由
旧 context 迁移的典型事故是“provider 改了、某个角落的 consumer 没改”,运行时才暴露。本技能把“先找全 provider 和 consumer,再按固定顺序逐个 context 迁移,每迁一个就验证”写成流程,并配齐前后对照代码,Agent 批量改写时不必凭记忆判断。纯文档内容,零配置即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | skills.sh 记录独立安装量 745 次,首次收录于 2026-04-09;合集仓库 stars 不计入本技能个体热度 |
| 可用性 | 7 | 主文件加三份带完整前后对照的参考文档(合计约 14KB),无需配置;技能自 2026-04-09 提交后未再更新,距今约 6 个月 |
| 安全性 | 9 | 见下方检查清单 |
综合分为三项均值。安全检查清单:① 全文是迁移参考,附带的命令只有只读的 grep 扫描,不要求执行写操作或安装;② 不联网、不外发数据;③ 不要求任何 API key 或凭据;④ SKILL.md 与三份参考文件通读,无可疑指令或夹带推广内容;⑤ 托管于 GitHub 官方组织下的合集仓库,经维护流程审核合并;⑥ License 明确(MIT);⑦ 仓库整体持续维护,最近一次推送为 2026-10-16。
7. 跟同类 Skills 相比的优势
| 候选 | 核心定位 | 差异 |
|---|---|---|
| react18-legacy-context(本技能) | 旧 context API 到 createContext 的跨文件迁移 |
强调 provider 与全部 consumer 协同修改,含扫描命令、多 context 并存的处理和统一的 context 文件模板 |
| react18-lifecycle-patterns(同仓库) | componentWillMount 等三个不安全生命周期的迁移 |
处理生命周期方法,不涉及 context |
| react18-string-refs(同仓库) | 字符串 ref 迁移到 createRef |
只处理 ref 写法,不涉及 context |
| React 官方文档(Legacy Context 页面) | 说明旧 API 的用法与弃用原因 | 讲 API 本身,不提供批量迁移的步骤顺序、扫描命令与多 context 拆分做法 |
本技能的差异化在于把迁移当作“多文件协同改动”来组织:先扫全、再逐个 context 迁移并验证。覆盖范围限于旧 context 一个主题。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 提供其独立安装量(745)。
9. 其他补充
同一贡献者在合集仓库中提交了一组 React 18/19 升级系列技能(依赖兼容性、批处理、生命周期、字符串 refs、Enzyme 到 RTL 等),可按升级阶段分别取用。
10. 安装使用方式
- 一条命令安装(推荐):
npx skills add https://github.com/github/awesome-copilot --skill react18-legacy-context - 手动安装:把仓库
skills/react18-legacy-context/目录(含SKILL.md与references/)整体复制到所用 Agent 的 skills 目录,例如 Claude Code 的.claude/skills/react18-legacy-context/ - 安装后无需重启;在对话中提到“迁移 legacy context”“替换 contextTypes / childContextTypes”“类组件升级 React 19”等意图即可触发
11. 注意事项
- 内容仅针对旧 context API,不涉及其他 React 18/19 破坏性变更
- 技能不会代为运行应用,迁移后需自行启动应用确认不再出现 legacy context 警告
- 参考代码以类组件 + PropTypes 的典型写法为例,实际项目中若有 Redux、react-router 等库内部使用旧 context,需先升级到支持新 API 的版本
- 技能自 2026-04-09 后未更新,React 19 稳定后的细节变化需自行对照官方升级指南