用途:在 openshift/lightspeed-operator 仓库中把当前特性分支干净地 rebase 到 upstream/main,强调最小冲突解决与完整验证,避免代码丢失。
主要能力与流程:
- 先用 git branch --show-current 检测当前分支,并请用户明确确认后再操作;用户指定目标分支时须核对是否与当前分支一致。在 reset/rebase 前须复述当前分支、目标分支和已批准的基线引用。
- 仅当此前 rebase 失败或引入多余改动时,才执行恢复步骤:git checkout <branch>、git reset --hard <backup-or-approved-base>、git fetch upstream;首次 rebase 直接进入下一步。
- 执行 git rebase upstream/main,冲突时只解决冲突文件,不做无关重构;行为尽量保留特性提交,除非与上游删除/重命名不兼容。go.mod 或 go.sum 冲突优先采用上游版本,之后运行 go mod tidy。解决后 git add <resolved files>,再用 GIT_EDITOR=true git rebase --continue 继续。
- 用 git range-diff、git diff --name-status、git merge-base --is-ancestor upstream/main HEAD、git log --left-right --cherry-pick --oneline 等检查相对已批准基线是否丢代码;任一检查失败视为代码丢失风险,需从步骤 1 重启。
- 若改动了 api/v1alpha1/ 下文件,运行 make generate、make manifests,并 git add api/ config/ 与 git commit --amend --no-edit。
- 验证必须运行 make test && make lint,严禁直接用 go test(Makefile 负责 envtest、CRD、构建标志等环境)。验证或丢代码检查失败时,回退到已批准基线并重跑流程,直到全部通过。
- 仅在用户要求或改动影响 reconciliation 逻辑时运行 make test-e2e,需要已部署 operator 的 OpenShift/Kubernetes 集群。
- 最终仅汇报 rebase 是否完成、当前分支与 ahead/behind 状态、make test、make lint、make test-e2e(若运行)、清单是否重新生成。
限制:不创建额外临时分支(除非用户明确要求);不做无关编辑;不停留在分析阶段;输出保持简短可操作;不假设目标分支名。
分类:智能体与模型(agents),因为这是面向 AI 编码代理的可执行工作流技能。