SuperAPI AI 工具集

sanity-ui-migration-progress

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:报告某个目录树中 @sanity/ui 向 v5 迁移的进度。它假定采用并存方案:@sanity/ui 仍为 v3 或 v4,v5 通过包别名安装(如 package.json 中 "ui5": "npm:@sanity/ui@alpha");已迁移组件从别名导入,未迁移组件仍从 @sanity/ui 导入,二者可逐组件共存。

主要能力:统计各组件的 v5 别名导入文件数、旧包导入文件数、两者并集,按绑定来源统计 JSX 实例的已迁移/未迁移/总数与百分比,以及 styled(LocalName) 定义点数量。支持发现模式(列出至少有一个 v5 导入的组件)和指定组件模式(用 --component 可测量尚未开始迁移的组件)。

使用方式:在仓库根目录运行脚本。所有进行中的组件:bash .agents/skills/sanity-ui-migration-progress/scripts/measure-progress.sh <dir> [v5-alias] [@sanity/ui];指定组件:bash .agents/skills/sanity-ui-migration-progress/scripts/measure-progress.sh <dir> --component Flex(可重复 --component)。参数 <dir> 必填,默认别名 ui5,旧导入路径 @sanity/ui。不确定别名时可用 rg -o '"([^"]+)":\s*"npm:@sanity/ui@' package.json -r '$1' 检测;默认 ui5 找不到导入时会从 <dir> 或下方的 package.json 自动检测。

适用场景:用户询问迁移进度或覆盖率;对比保存的基线;CI 或周期性快照。

限制:范围影响统计结果,需报告所用目录,monorepo 中 v5 导入可能分布在多个包,仅扫描主库会低估进度;条件表达式如 cond ? Box : Card 不计入;跨文件 styled 包装只在定义处计数;重导出/barrel 要求绑定出现在使用文件中;一个文件混合导入可能需人工复核;发现模式不显示尚未使用 v5 的组件,需用 --component 指定。本技能只报告,不安装依赖也不执行迁移;若不存在 v5 设置,应说明并停止。