/git-snapshot-rollback

name: git-snapshot-rollback
description: 存档当前的失败尝试分支，并安全回退到特定历史提交
license: Apache-2.0
author: github/cafe3310
depends_on_skill: []
depends_on_binary:
  - git
  - python3

Git Snapshot & Rollback

此技能通过自动化脚本确保在回退 Git 提交时，不仅保留了当前的尝试（Snapshot），还通过 `ARCHIVE.md` 构建了一个可追溯的决策链表。

核心工作流

1. 确认回退目标

• 获取用户想要回退到的目标 Commit Hash。
• 询问或总结回退的具体原因（Reason）。

2. 执行自动化回退脚本

• **在执行前，必须询问用户是否需要将存档分支推送到远端仓库。**
• 使用 `run_shell_command` 调用技能内置脚本：
• 如果用户同意推送：`python3 <path_to_skill>/scripts/rollback.py <Target_Commit> "<Reason>" --push`
• 如果用户不同意推送（默认）：`python3 <path_to_skill>/scripts/rollback.py <Target_Commit> "<Reason>"`
• **脚本将自动完成**：

1. Commit 当前所有未提交的变更。 2. 创建 `archive/{current_branch}/YYYY-MM-DD-HH-mm` 分支。 3. 更新存档分支的 `ARCHIVE.md` 记录。 4. (可选) 将存档分支推送到远端。 5. 回到原分支并执行 `git reset --hard`。 6. 在原分支更新 `ARCHIVE.md` 并提交回退记录。 7. 列出当前所有领先于远程（未推送）的分支。

3. 结果验证

• 检查 `ARCHIVE.md` 是否已正确记录了本次回退的双向链接。
• 确认当前分支已处于目标 Commit 状态。

记录规范

• 关于 `ARCHIVE.md` 的具体格式，请参考 [references/log-format.md](references/log-format.md)。
• 每次回退的 Commit Message 必须包含来源存档分支的信息。

使用禁令

• 严禁在没有使用此技能的情况下直接执行 `git reset --hard` 来放弃大量工作。
• 不得修改或删除 `ARCHIVE.md` 中的历史记录。