用途:在上游变更分析与影响映射已完成、工作范围已收敛为高置信项后,为 Megatron 特性迁移到 MindSpeed 生成实现导向的迁移交付物。目标是以上游提交为主要参考完成移植,而非输出简短补丁提示。
输出模式:默认 report+patch,最终 Markdown 交付物默认中文,除非用户明确指定其他语言;不默认直接改代码或自动提交。支持四种模式:report 仅生成迁移报告;patch 生成报告加完整实现参考包,默认按特性文件夹组织,含 full.patch、split patches/、上游参考元数据、实现清单与未覆盖范围;apply 在本地工作区修改但不提交,仅在对齐与影响置信度高时使用;commit 仅限用户在补丁评审后明确要求,不作为首次默认。
进入条件:需已知 MindSpeed 分支、Megatron 基础分支、Megatron 目标分支或变更集,且已有相关影响项,每个值得迁移的项包含上游提交引用与足够区分配置/运行时/包装/测试的实现范围;缺失时应停止并索取或推导前置条件,不得猜测。
工作流:读取影响报告,区分高置信与推测项;逐一描述上游事件、提交与变更文件、实现单元、本地适配目标、预期代码改动与不确定性;生成 integrated migration_report.md、必要时 impact_report.json、candidate_patch.md 索引,以及 features/ 下每项含 full.patch、patches/、candidate.patch、README.md、checklist.md、package_manifest.json、upstream_reference.json;apply 模式仅改已批准文件并说明改动。
安全规则:不得无影响报告直接从原始提交历史生成迁移代码;探索模式避免直接编辑;目标为 megatron main 时输出应表述为候选适配草稿而非兼容性保证;优先补丁产物而非提交;上游跨配置/运行时/包装/测试时不得以单文件编辑视作完整迁移;无法完成完整包时明确记录未覆盖实现单元、省略范围与人工跟进。
静态验证:保持轻量本地验证,如补丁可干净应用、路径存在、名称与参数匹配本地结构、可用时做基础语法或 lint 检查,并说明哪些上游实现单元已移植、哪些待移植;不得暗示已验证训练正确性、性能或数值精度。
参考文件:选择输出形式前读 migration-modes.md;生成声称代表特性实现的迁移包前读 implementation-first-package.md;读 report-template.md 了解集成 Markdown 结构,默认中文。影响映射后运行 synthesize_full_patch_series.py 将已知特性提交扩展为多文件补丁系列;运行 render_migration_artifacts.py 将 impact_report.json 转为可评审的报告与补丁计划产物。分类:智能体与模型。