用途:将选定的基线分支合并进当前分支,并在合并后完成清晰的 lint、完整测试覆盖率和成功构建,适合希望把分支与父分支完全对齐并让本地检查达到 CI 质量时使用。
主要流程:确认当前分支(分离 HEAD 时停止);判定基线分支候选并让用户选择(先读仓库根部 .agent 中的 baseBranch 值,否则通过 git merge-base --fork-point 判定 main、master、develop,按 main、master、develop 优先级取候选,均不匹配则无候选);始终提供 main 选项。
选择后校验基线分支并执行 git fetch origin <base-branch>;若 HEAD..<merge-ref> 计数为 0,说明已包含基线全部提交,停止且不提交、不合并、不跑检查。否则先提交所有未提交工作,再执行 git merge origin/<base-branch> --no-edit;遇冲突列出后逐文件解决、git add,再 git merge --continue --no-edit。随后依次执行 npm run lint(失败则修复重跑)、npm run test:coverage(失败则补充或调整测试直至全部行覆盖达到 100%)、npm run build(修复编译或打包错误重跑),每次有文件变更时提交。最后汇总基线分支、合并结果、各项检查结果与本次创建的提交。
前提与限制:仓库根目录必须是命名分支的 Git 检出,不能在分离 HEAD 状态;Node/npm 项目需要 package.json 并定义 lint、test:coverage、build 脚本,缺失则报告并停止,不进行合并或后续强制检查。其他平台或具体安装方式暂未提供。