Agent Skills
返回列表
💻

React 现代化

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/react-modernization-zh。

技能介绍

你在解决什么问题

老项目往往卡在旧版 React、大量类组件和过时的状态写法上。升级大版本时容易踩生命周期与 API 变更;手工把 componentDidMount 改成 useEffect 既慢又容易漏边界。并发模型(Suspense、useTransition)和 TypeScript 迁移如果没有清晰路径,团队会在「能跑」和「能维护」之间反复拉扯。

技能如何帮你推进

本技能把 React 现代化 拆成可核对的目标与约束:先明确版本目标、是否动状态层、是否要 codemod 批量改码,再按最佳实践给出可执行步骤和验证方法(行为一致、测试/冒烟、关键页面回归)。

核心能力包括:

  • 版本升级:对齐官方迁移说明,处理破坏性变更与依赖兼容
  • 类组件 → Hooks:函数组件、useState / useEffect 及常见模式替换
  • 并发特性:在合适场景采用 Suspense、transitions,避免误用导致体验倒退
  • 自动化重构:选用并应用 codemods,减少手工 diff 量
  • 状态与类型:现代化状态管理模式,按需迁到 TypeScript

需要更细的代码模式与示例时,技能指向 resources/implementation-playbook.md 作为实施手册。

适用边界

任务与 React 栈现代化无关(例如纯后端、非 React 前端框架)时不要用本技能。若问题落在本技能范围外的工具链或领域(特定构建平台、与设计系统无关的 UI 库大换血等),应先缩小范围或换用对应专项技能,避免把「整个前端重写」误当成一次现代化会话。

使用场景

  • 主应用仍停在 React 16/17,需要制定升级到 React 18+ 的变更清单并逐步验证关键页面
  • 遗留代码库里有上百个类组件,要在不改动业务逻辑的前提下批量迁到函数组件与 Hooks
  • 新功能要用 Suspense 做数据加载或 useTransition 做交互过渡,需要评估改造点与回退策略
  • 团队准备引入官方或社区 codemod,把 setState/生命周期相关模式自动改写并做 diff 审查

适合人员

  • 维护五年以上 React 单体前端的 Tech Lead,要在本季度完成大版本升级并控制回归风险
  • 负责组件库与业务模块的资深前端,需要把类组件与旧生命周期统一迁到 Hooks 并补齐测试
  • 从 JavaScript 迁 TypeScript 的架构师,要同步梳理 React 类型、状态层与并发 API 的改造顺序
  • 带外包或初级同学做重构的工程师,需要可复制的步骤、验证清单与 playbook 级示例对照实施