SuperAPI AI 工具集

git-snapshot-rollback

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:在需要放弃当前 Git 工作并回退到某个历史提交时,先存档当前分支的失败尝试,再安全执行回退,避免直接 git reset --hard 造成大量工作丢失。

主要能力:脚本会自动提交当前所有未提交变更;创建 archive/{current_branch}/YYYY-MM-DD-HH-mm 存档分支;更新存档分支的 ARCHIVE.md;可选推送存档分支到远端;回到原分支执行 git reset --hard;在原分支更新 ARCHIVE.md 并提交回退记录;列出所有领先于远程的未推送分支。

使用方式:先确定目标 Commit Hash 与回退原因;执行前必须询问用户是否将存档分支推送到远端。同意推送时运行 python3 <path_to_skill>/scripts/rollback.py <Target_Commit> "<Reason>" --push;不同意(默认)则去掉 --push。完成后验证 ARCHIVE.md 是否记录了本次回退的双向链接,并确认当前分支已处于目标 Commit。ARCHIVE.md 格式参见 references/log-format.md,每次回退 Commit Message 须包含来源存档分支信息。

限制与禁令:严禁在未使用此技能的情况下直接执行 git reset --hard 放弃大量工作;不得修改或删除 ARCHIVE.md 中的历史记录。