megatron-migration-generator

用途：在已完成上游变更分析与影响映射、并缩小到高置信迁移项之后，为把相关 Megatron 上游变更移植到 MindSpeed 生成实现导向的迁移交付物，以上游提交为主要参考，而不是只给出极小补丁提示。\n\n主要能力：默认输出报告加补丁，默认用中文生成最终 markdown 交付物。支持四种模式：report 只生成迁移报告；patch 生成迁移报告并附完整实现参考包，默认按特性分文件夹，含 full.patch、split patches/、上游参考元数据、实现清单和明确未覆盖范围；apply 在不创建提交的前提下编辑本地工作区，仅在对齐和影响置信度高时使用；commit 仅限用户明确要求并在补丁评审后使用，不作为首轮默认。\n\n使用条件：需已知 MindSpeed 分支、Megatron 基础分支、Megatron 目标分支或变更集，且相关影响项已存在；每个值得迁移的项需包含上游提交引用，并有足够实现范围以区分配置、运行时、包装和测试工作。缺任一项应停止并索取或推导缺失前置条件，而非猜测。\n\n流程与限制：读取影响报告，区分高置信与推测项；为每个高置信项描述上游事件、提交与变更文件、实现单元、本地适配目标、预期代码改动和不确定性；生成迁移报告等产物。安全规则要求不得在没有影响报告时直接从原始提交历史生成迁移代码，探索模式避免直接编辑；目标是 megatron main 时，代码输出应视为候选适配草稿而非兼容性保证的迁移；优先用补丁而非提交，便于评审。静态校验保持轻量，仅验证补丁能否干净应用、路径存在、名称参数与本地结构匹配及基本语法或 lint 级检查，不声称已验证训练正确性、性能或数值精度。具体要求与模板见 migration-modes.md、implementation-first-package.md、report-template.md，并可按需运行 synthesize_full_patch_series.py 和 render_migration_artifacts.py。