AI 提示词：Git运维操作助手

基于输入

• 目标分支：prod（远程：origin）
• 操作类型：回滚
• 回滚目标提交：a1b2c3d

以下流程采用 git revert（新增逆向提交），避免使用破坏性命令，确保远程仅做快进推送，不使用强制推送。

命令

1) 前置检查与备份（强烈建议）

# 同步远程最新状态
git fetch origin --prune

# 确认工作区干净
git status --porcelain

# 确认待回滚提交在 prod 历史中（返回码为0表示是祖先）
git merge-base --is-ancestor a1b2c3d origin/prod

# 备份当前远程 prod 指针（打保护标签）
git tag -a backup/prod-before-revert-$(date +%Y%m%d-%H%M%S) origin/prod -m "Backup before reverting a1b2c3d"
git push origin --tags

2) 基于 prod 创建回滚分支（避免直接在 prod 上动手）

# 从远程 prod 创建本地回滚分支
git switch -c hotfix/prod-revert-a1b2c3d origin/prod

# 可选：确认目标提交信息
git show --no-patch --pretty=fuller a1b2c3d

3) 安全回滚（revert）单个提交

先判断该提交是否为合并提交：

# 查看父提交数量（>1 表示为合并提交）
git show -s --format=%p a1b2c3d

• 若为普通提交（单父提交），执行：

git revert --no-edit a1b2c3d

• 若为合并提交，需指定主线父提交，一般 prod 为 parent 1：

git revert -m 1 --no-edit a1b2c3d

如需一次回滚但暂不提交以便批量处理（可选）：

# 普通提交
git revert --no-commit a1b2c3d && git commit -m "Revert a1b2c3d on prod"

# 合并提交
git revert -m 1 --no-commit a1b2c3d && git commit -m "Revert merge a1b2c3d on prod (mainline=1)"

4) 冲突处理命令

发生冲突时：

# 查看冲突文件
git status

# 按需取用版本（谨慎使用以下二选一）：
# 保留当前分支（prod现状）版本：
git checkout --ours -- .
# 或采用回滚变更侧的版本：
git checkout --theirs -- .

# 逐个文件手动编辑冲突标记后，添加到暂存
git add <file1> <file2> ...

# 继续完成 revert
git revert --continue

# 若需要放弃此次回滚（未完成前）
git revert --abort

说明：

• 在 revert 冲突中，--ours 倾向于保留当前 prod 的内容，--theirs 倾向于采纳“回滚补丁”侧的内容。实际以冲突语义为准，建议逐文件审阅。

5) 推送与合入远程

首选做法：将回滚分支推送到远程，由受保护策略合入 prod。

# 推送回滚分支
git push -u origin hotfix/prod-revert-a1b2c3d

如果必须直接更新远程 prod（确认无保护策略阻止，且已完成必要审查）：

# 方式A：在回滚分支上直接推送到远程 prod（快进，无强推）
git push origin hotfix/prod-revert-a1b2c3d:prod

# 或方式B：先在本地将回滚结果合并入本地 prod，再推送
git switch -c prod-update origin/prod
git merge --no-ff --no-edit hotfix/prod-revert-a1b2c3d
git push origin HEAD:prod

6) 回滚结果验证

# 拉取并确认远程 prod 最新提交包含 Revert 提交
git fetch origin --prune
git log --oneline -n 5 origin/prod

# 对比回滚前后变化（需要使用之前的备份标签名）
git diff --stat backup/prod-before-revert-<timestamp>..origin/prod

7) 出现问题时的撤销与恢复

如误回滚且已推送（仍保持非破坏策略），用“再次 revert”撤销此前的 Revert 提交：

# 找到刚才的 Revert 提交哈希（记为 R）
git log --grep="Revert" --oneline origin/prod

# 反向回滚（撤销回滚）
git switch -c hotfix/prod-unrevert-R origin/prod
git revert --no-edit R
git push -u origin hotfix/prod-unrevert-R

# 按流程合入 prod（见第5步）

说明

• 全流程使用 git revert 生成新的逆向提交，属于可追溯、可回退的安全操作，不改写历史。
• 通过在独立分支完成回滚与冲突处理，避免直接影响远程 prod。
• 若目标提交为合并提交，必须使用 -m 指定主线父提交，通常 prod 为 parent 1；请通过 git show -s --format=%p 验证。
• 备份标签用于一键定位回滚前的远程 prod 状态，必要时可对比或再回滚。

安全提示

• 禁止在共享/生产分支上使用以下破坏性操作：git reset --hard、git push --force、git push --force-with-lease、历史改写（rebase/filter-branch/git replace）等。
• 回滚前务必 git fetch 并确认本地与 origin/prod 同步；确保工作区干净再操作。
• 优先将回滚提交推送到回滚分支，经审查后再合入 prod；若需直接更新 prod，确保仅做快进推送。
• 合并提交回滚时务必确认主线父提交（-m 参数），错误的主线会引入相反方向的变更。
• 冲突解决请逐文件确认，不要盲目全量 ours/theirs。
• 统一使用完整或足够长度的提交哈希，避免短 SHA 歧义（a1b2c3d 需在仓库内唯一）。

目标

• 目标分支：dev
• 操作类型：推送
• 回滚目标：#{rollback_commit}

以下为安全、无破坏性的 Git 远程推送、回滚与冲突处理命令及说明。

一、基础准备（建议先执行）

# 查看并同步远端
git remote -v
git fetch --prune origin

# 切换到 dev 分支并确认跟踪关系
git switch dev  # 若提示不存在可用：git checkout dev
git branch -vv
git branch --set-upstream-to=origin/dev dev  # 若未设置上游

# 确认本地与远端差异
git log --oneline --graph --decorate origin/dev..dev
git status

说明：

• 确保工作区干净（无未提交改动）再执行远程操作。
• 确认 dev 已跟踪 origin/dev，避免误推到错误远端。

二、远程推送到 dev（非破坏性）

# 1) 确保本地可快进更新（避免产生不必要的合并提交）
git pull --ff-only origin dev

# 2) 推送本地 dev 到远端
git push origin dev

说明：

• 使用 --ff-only 确保只是快进更新，不会自动产生 merge 提交。

若推送被拒绝（提示非快进/需要先拉取）：

方案 A（团队允许线性历史，且本地提交未推送过）：优先使用 rebase

git fetch origin
git rebase origin/dev   # 将本地提交变基到最新的 origin/dev 之上

# 若出现冲突，解决后：
git add <冲突文件...>
git rebase --continue   # 或 --abort 放弃变基
# 变基完成后推送
git push origin dev

方案 B（团队偏好合并提交）：

git fetch origin
git merge --no-ff origin/dev   # 产生一条合并提交，保留历史分叉
# 解决冲突后：
git add <冲突文件...>
git merge --continue   # 或 --abort 取消合并
git push origin dev

三、非破坏性回滚到 #{rollback_commit}

在共享分支上回滚，使用 git revert 生成新的逆向提交，避免重写历史。

通用保护（强烈建议先做备份分支或标签）：

# 以当前 dev 创建备份分支（可自定义名称）
git branch backup/dev-rollback-<your-tag> dev

1. 回滚单个指定提交：

git switch dev
git pull --ff-only origin dev
git revert --no-edit #{rollback_commit}

# 本地验证通过后推送
git push origin dev

说明：该操作仅撤销该次提交的变更，不改变历史结构。

2. 回滚到某历史状态（撤销 #{rollback_commit} 之后的所有提交）

• 含义：将 dev 的内容回到 #{rollback_commit} 的效果，但通过生成一组/一个逆向提交来实现（不重写历史）。
• 安全做法（按从新到旧的顺序逐个 revert，排除合并提交）：

git switch dev
git pull --ff-only origin dev

# 逐个撤销 #{rollback_commit}..HEAD 区间内的普通提交（从新到旧）
git rev-list --no-merges #{rollback_commit}..HEAD | xargs -n 1 git revert --no-edit

# 若愿意在一次提交中完成，可改用（易遇到冲突时集中处理）：
# git revert --no-commit #{rollback_commit}..HEAD
# git commit -m "Revert to #{rollback_commit} on dev (non-destructive)"

git push origin dev

说明：

• 若区间内包含合并提交，需要单独处理该合并提交，通常用 -m 指定主线父分支：

# 示例：回滚某个合并提交（以第 1 父为主线，按实际需调整父编号）
git revert -m 1 <merge_commit_sha>

四、冲突处理流程（适用于 rebase/merge/revert）

# 1) 查看状态与冲突文件
git status

# 2) 打开并解决冲突（编辑标记 <<<<<<< ======= >>>>>>>）
# 3) 标记解决
git add <已解决的文件...>

# 4) 根据操作继续
#   - 变基： 
git rebase --continue      # 继续
# git rebase --skip        # 跳过当前补丁（审慎使用）
# git rebase --abort       # 放弃变基并回到开始前状态

#   - 合并：
git merge --continue       # 继续
# git merge --abort        # 放弃合并

#   - 回滚：
git revert --continue      # 继续
# git revert --abort       # 放弃此次回滚

五、验证与推送

# 本地验证（示例）
git diff --stat
git log --oneline --graph --decorate -n 20
# 运行项目构建/测试脚本（根据项目实际）

# 推送到远端
git push origin dev

安全提示

• 禁止对共享分支使用强制推送（如 git push --force/--force-with-lease）。本流程均为非破坏性操作。
• 避免在已推送的公共提交上做历史重写（如 rebase/commit amend 后再强推）。
• 回滚优先使用 git revert，必要时先创建备份分支（如 backup/dev-rollback-...）。
• 拉取时优先使用 --ff-only，防止意外产生合并提交；若需合并，请人工确认并记录。
• 冲突解决后务必本地构建与测试通过再推送，以降低对生产的影响。
• 如需回滚合并提交，必须明确主线父分支（-m 参数），并谨慎评估影响范围。