Radix至Base UI代码迁移
接收基于 Radix UI 的 React 或 shadcn 组件代码,通过三方模板比对与属性映射平滑重构为 Base UI 原语,并输出带有类型校验与行为差异
功能与用途
专为 React 与 shadcn/ui 技术栈设计的前端重构流程。它支持单组件渐进式迁移(绞杀者模式)与全项目批量切换两种工作流,先检查 git 状态与类型系统基准,再利用官方样式基准(Golden Pair)进行三方合并,完整保留开发者的定制样式与逻辑;对于无对应原语的特殊组件(如 AspectRatio、Label)提供原生替代方案,确保替换期间应用始终可编译构建,并在迁移完成后在 .migration 目录生成逐个组件的审查日志与手动验证清单。
适用场景
- 单个组件渐进式绞杀迁移:通过生成过渡基底文件逐个替换引用,在确保应用随时可构建的前提下平滑过渡。
- shadcn项目样式无损转换:利用官方黄金样本基准执行三方代码合并,完整保留项目既有的自定义样式与行为。
- 无对应原语的兼容重构:为缺少 Base UI 对标的原语提供原生 HTML 或 CSS 规范替换方案,消除依赖包残留。
适用人群
- React 前端开发工程师
- shadcn/ui 技术栈维护者
- 前端架构师与技术重构负责人
使用步骤
- 运行环境检测并建立类型检查基线,安装 @base-ui/react 依赖
- 根据项目风格抓取官方基准代码,对自定义 wrapper 进行三方比对合并或语法规则重写
- 重定向业务调用方(consumer)的属性与导入路径,逐个执行类型校验与编译检测
- 清理无残留引用的旧代码或 Radix 依赖,在 .migration 目录写入差异与人工核验报告
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
依赖与权限
- 读取用户主动提供的内容