关于 migrate-to-rslib
migrate-to-rslib 是将 tsc 或 tsup 项目迁移到 Rslib 的 Agent 技能,强调尽量减少行为变化,并在验证构建通过后再清理旧配置。
主要功能
- 01识别 tsc 和 tsup 项目
- 02遵循官方迁移指南
- 03优先采用最小改动
- 04清理前验证构建
- 05总结变更与后续事项
适用场景
- 01将 tsc 构建迁移到 Rslib
- 02将 tsup 项目迁移到 Rslib
- 03检查迁移后的项目构建
- 04梳理尚未完成的迁移任务
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rstackjs/ agent-skills --skill migrate-to-rslib安装后在 Claude Code 中输入/migrate-to-rslib确认已加载。
附带文件references/tsc.mdreferences/tsup.md
详细介绍
迁移到 Rslib
目标
将 tsc 和 tsup 项目迁移到 Rslib,尽可能减少行为变化,并清晰地进行验证。
支持的源框架
- tsc
- tsup
迁移原则(必须遵守)
- 优先遵循官方指南:以 Rslib 迁移文档为准。
- 优先进行最小改动:先完成基线迁移,再迁移高级或自定义行为。
- 不要更改业务逻辑:除非用户明确要求,否则避免修改源代码或业务逻辑。
- 验证后再清理:必要时暂时保留旧工具的依赖和配置;只有在 Rslib 验证通过后才移除。
工作流
-
检测源工具
tsup- 配置:
tsup.config.* - 依赖:
tsup - 构建脚本:使用
tsup构建项目
- 配置:
tsc- 配置:
tsconfig.json或tsconfig.*.json - 依赖:
typescript - 构建脚本:使用
tsc构建项目。请注意,仅用于类型检查的tsc(例如tsc --noEmit)并不意味着这是一个tsc构建项目。
- 配置:
-
应用特定工具的迁移差异
- tsc:
references/tsc.md - tsup:
references/tsup.md
- tsc:
-
验证行为
- 运行构建命令,确认项目可以成功构建。
- 如果仍有问题,请对照旧项目配置和迁移指南,补全任何缺失的映射。
-
清理并总结
- 只有在验证通过后,才移除不再需要的依赖和配置。
- 总结已更改的文件、已映射的选项,以及仍需手动处理的事项。
评论
支持 Markdown