泛微项目异构迁移
面向异构系统历史数据迁移，统一组织迁移范围、处理任务和客户迁移包交付，并与泛微项目交付流程衔接。
核心能力
| 业务场景 | 能力说明 | 交付结果 |
|---|---|---|
| 迁移范围梳理 | 识别异构系统类型、迁移范围和必要输入 | 可执行的迁移任务边界 |
| 迁移数据处理 | 统一调度专业数据迁移能力 | 可追溯的处理回执 |
| 客户迁移包 | 按已确认范围准备并校验Ecology迁移包 | 可核验的客户交付包 |
| 项目协同 | 将确认、授权、上传和全局状态交回项目总控 | 连续的项目交付链路 |
使用流程
先确认项目交付总控已安装；migration_plan 先展示输入清单并等待用户确认同一摘要，再调度专业迁移处理。其他迁移操作按对应契约一次性检查运行环境与认证状态。分支确认后检查当前仓库的真实Git姓名和邮箱。中断后直接从失败阶段继续，不重复已完成的裁剪、提交、推送、CI或下载；确认和外部操作仍交回项目总控。
执行契约
本包是数据迁移领域二级总控，内部包含 weaver-datamigrate-data、weaver-datamigrate-oa-data-dictionary、weaver-datamigrate-source-package 和 weaver-datamigrate-plan 四个专业 worker，均不得被用户直接调用。完整保留 root_dispatch_id、scope_id 和 resume_token；项目确认、全局状态、认证、上传和外部写入必须返回 weaver-project-delivery。
迁移出包与迁移方案生成均使用唯一Python入口和直接进程调用，不依赖PowerShell、CMD、Bash或临时移植脚本。migration_plan 必须消费真实 worker handoff，核验 DOCX、SHA-256、正式状态和校验结果后再向上级返回实体 artifacts。业务输入、Python、Git、临时目录及GitLab/Nexus认证缺项一次返回；本包不保存凭据、不自行登录、不安装依赖。阶段依次为预检、分支解析、裁剪预览、裁剪应用、客户信息、提交、推送、CI、下载和校验。最后校验必须有本次提交对应迁移程序的通过记录，否则停在校验步骤继续；outcome_unknown 必须停止，禁止自动重试。
直接调用时先把宿主已经发现的总控包记录传给 python scripts/ensure_primary_skillhub_package.py --action status --host-record <record.json>；宿主也可显式传入 --peer-root 与 --latest-version。迁移根不推断目录、不扫描宿主环境。宿主未发现总控，或总控不是宿主报告的最新版时，只向用户显示：
请根据 [https://skillhub.cn/install/skillhub.md，安装](https://skillhub.cn/install/skillhub.md) @user_040dcc29/weaver-project-delivery。
用户当次明确确认后，迁移根返回 HOST_INSTALL_LATEST_PACKAGE，由宿主无版本号安装或更新最新版。宿主回传 installStatus=succeeded 后，迁移根以根 SKILL.md 的 SemVer 为实际安装版本；release.json 的打包占位符不作为版本。迁移根核验纯协调总控的 frontmatter、release 格式/类型/目标/slug、空 capabilities/workers、entry 与模板路径、协调脚本，以及 registry/state-machine 路径；路径逃逸、身份错误或缺少必需文件均结构化停止。只有该次验证成功的安装回执可恢复原请求一次；后续 status=ready 静默返回且不得再次恢复。拒绝、失败或结果不确定时停止且不重试。
\n
