full-codebase-migrator

用途：该技能面向整仓库级别的代码迁移，通过大上下文窗口一次性摄入全部源码，理解整体架构后产出可供团队按顺序执行的逐文件迁移方案。支持的迁移类型（如 JS 转 TS、React class 转 hooks、框架迁移等）详见 references/migration-types.md，其中也说明了适用与不适用情形。主要能力：按工作流分八步——确定迁移类型、范围与输出位置；用 glob 与 Bash 收集元数据（行数、包清单、配置、git 历史、目录树），并读取每个源文件（500+ 文件的代码库可分派子智能体并行读取目录子树）；构建依赖图，提取导入、建立邻接表、分层、检测循环依赖、分类外部依赖；逐文件评估（层级、复杂度、模式、所需改动、前置依赖、风险、测试影响）；按拓扑排序并结合快速收益、高风险优先、先破环等调整，将文件分组为可构建的 PR 级阶段；按复杂度、中心性、波动性、测试覆盖、外部耦合打分并建立风险矩阵与回滚策略；估算单文件、单阶段与总工作量（含开销与 20% 缓冲）并折算日历时间；最后写出 migration-plan.md，必要时附 migration-plan.json 并对照检查清单校验。使用方式：在提示中给出迁移类型、范围（整仓库或目录）、输出位置及排除或约束条件，技能会尽量从提示中推断；文档结构为 references/migration-types.md、references/ingestion.md、references/workflow-detail.md、references/output-template.md。适用场景与限制：适合大型仓库、monorepo、部分已迁移或无测试代码库等，但后者需按边界情况调整处理，具体参见 references/output-template.md；其余细节以资料为准。