full-codebase-migrator

全代码库迁移器

充分利用完整的 1M token 上下文窗口，摄取整个代码库，从端到端理解其架构，并生成全面的逐文件迁移计划，让团队能够按顺序执行且不会产生冲突。

目录

• references/migration-types.md -- 支持的迁移类型；何时适用以及何时不应使用此技能。
• references/ingestion.md -- 架构、glob 模式、元数据收集、读取顺序、上下文预算和依赖关系图构建（步骤 0-2）。
• references/workflow-detail.md -- 逐文件评估、迁移顺序、风险评分和工作量估算模板（步骤 3-6）。
• references/output-template.md -- migration-plan.md 和 migration-plan.json 模板、边缘情况及最终质量检查清单（步骤 7-8）。

工作流

1. 确定范围。明确迁移类型、范围（整个仓库或目录）、migration-plan.md 的输出位置，以及任何排除项或限制。如果用户的提示中已说明，则据此推断。有关支持的类型及其适用性，请参阅 references/migration-types.md。
2. 摄取代码库。使用 glob 获取所有源文件，使用 Bash 收集元数据（行数、包清单、配置、Git 历史记录、目录树），然后读取每个源文件。对于包含 500 个或更多文件的代码库，派遣 Agent 子 Agent 并行读取各个目录子树。请参阅 references/ingestion.md。
3. 构建依赖关系图。提取每个导入项，生成邻接表，将每个文件划分到不同层级，检测循环依赖，并对外部依赖进行分类。请参阅 references/ingestion.md。
4. 评估每个文件。逐个文件提供迁移评估，涵盖层级、复杂度、发现的模式、所需变更、前置依赖、风险因素和测试影响。请参阅 references/workflow-detail.md。
5. 计算迁移顺序。按层级执行拓扑排序，进行实际调整（快速见效项、优先处理高风险项、首先打破循环依赖），并将文件分组为可构建、适合 PR 大小的阶段。请参阅 references/workflow-detail.md。
6. 评估风险。根据复杂度、中心性、变更频率、测试覆盖率和外部耦合，对每个文件按 1-5 评分。构建迁移级别的风险矩阵和回滚策略。请参阅 references/workflow-detail.md。
7. 估算工作量。计算逐文件、逐阶段和总工作量估算，并计入额外开销和 20% 的缓冲，然后根据团队规模换算为日历时间。请参阅 references/workflow-detail.md 和 references/migration-types.md 中的工作量校准表。
8. 生成交付物。将 migration-plan.md 写入输出位置；在有助于机器读取时，同时生成 migration-plan.json。交付前根据质量检查清单进行验证。请参阅 references/output-template.md。

边缘情况

上下文无法容纳的大型代码库、单体仓库、部分已迁移的代码库，以及没有测试的代码库，都需要调整处理方式。请参阅 references/output-template.md。