用途:在 Megatron 到 MindSpeed 的迁移工作中,解析正确的 MindSpeed 分支上下文,并将每个相关 Megatron 变更事件映射到具体的 MindSpeed 实现目标。该技能是实现导向迁移生成的前置关卡。
硬性门槛:分支对齐未明确前,不得生成迁移补丁。对齐来源仅限用户提供的映射、branch-alignment.md 中已明确的规则,或仓库本地文档/提交中写明的映射。若均不可用,只能停留在影响报告阶段。
核心规则:严格迁移模式下,MindSpeed 分支与 Megatron 分支的对齐是强制要求;首次分析仅以官方仓库为事实来源;区分严格迁移模式与探索模式;对 megatron main 优先采用探索模式,除非用户明确选择兼容的 MindSpeed 基线;将结果分为已适配、可能可适配但缺失、暂不值得适配三类;当功能明显值得迁移时,不停止于“候选路径”,而是拆分为与上游实现单元对应的实现目标。
工作流:解析 MindSpeed 分支;解析映射的 Megatron 基线分支;将基线与目标 Megatron 分支或变更集比较;对每个相关事件搜索 MindSpeed 模块、包装器、配置、启动路径和测试;将上游实现单元映射为本地实现目标;产出含置信度、理由和实现范围的影响报告;仅高置信度影响项可交接给迁移生成。
输出:影响报告(impact_report)包含 mindspeed_branch、megatron_base_branch、megatron_target_branch、mode、items 等字段,每项含 event_title、status、confidence、candidate_paths、reason、primary_commit、upstream_changed_files、implementation_targets、covered_units、missing_units。
决策规则:对齐未解析则仅报告;对齐已解析但实现目标支撑薄弱则报告加实施计划,不直接编辑;对齐与实现目标均高置信度才允许生成迁移补丁;若上游事件明显跨多个实现单元而本地仅触及一个文件,须显式标记未覆盖单元。
参考与工具:严格迁移前阅读 branch-alignment.md;搜索候选适配路径时阅读 mindspeed-focus-areas.md;运行 resolve_branch_alignment.py 确定分支对分类;运行 scan_mindspeed_paths.py 按功能名、文件名、符号或配置键搜索;运行 map_implementation_targets.py 转换实现目标;仅将已批准项交接给 $megatron-migration-generator。