用途:在特性分支工作多日后,main 已前进,本技能系统性分析上游变更、判断兼容性,并在执行合并前生成清晰的合并计划文档,降低回归风险。
主要能力:解析参数(--plan 指定计划目录、--target 指定来源分支,默认 main);校验 git 状态(工作区干净、非 detached HEAD、目标分支存在);通过 git merge-base 找共同祖先,无共同祖先时进入降级模式;提取三方版本(祖先、main、本地);检测计划模式(Simple/Full)并在跨模式时告警;启动多个子代理并行分析:上游计划发现、各上游计划分析、本地变更分析、文件冲突检测、语义冲突检测、回归风险分析、合并顺序综合;输出文件冲突表、语义冲突表、回归风险表与推荐合并顺序。
使用方式:在计划目录或仓库中调用 /8 或 /merge,可加 --plan 与 --target。资料建议合并前先建备份分支:git branch backup-$(date +%Y%m%d)-before-merge。
限制:依赖 git 仓库与计划目录中的 *-spec.md;无共同祖先时冲突分类准确度下降;FlowSpace 不可用时跳过代码级验证,仅基于摘要判断;跨模式合并需人工介入脚注账本与任务表协调;输出为计划文档,不自动执行合并。