用途:rollback 用于安全撤销已提交或已发布的变更,采用非破坏性的 git revert 或 restore,保留完整 git 历史,且回滚本身可被再次回滚。仅在用户明确要求回滚、还原或撤销时使用。
主要能力:提供交互式菜单,含 6 个选项——回滚最后一次提交、按哈希回滚指定提交、回滚已合并的 PR、回滚指定文件、回滚整个分支、预览回滚(干跑,只显示变更不执行)。
安全机制:要求工作目录干净(无未提交变更),否则提示先提交或暂存;校验提交哈希须匹配 /^[0-9a-f]{4,40}$/i 或为 HEAD;文件路径须在项目内以防路径穿越;方法白名单为 commit、pr、partial、branch;拒绝 shell 元字符(;、|、&、$、`、(、)、<、>、换行等)。使用 git revert 创建新提交,不使用 git reset --hard。
USER 内容保留:回滚前自动提取 <!-- USER:START --> 与 <!-- USER:END -->(含命名形式)之间的内容,备份 .claude/commands/custom/ 下的自定义命令,回滚后恢复并 amend 到回滚提交中,使自定义内容在回滚后仍保留。
使用方式:运行 bunx forge rollback,按交互菜单选择方法。各方法的完整步骤、命令、提示与预期输出见 references/methods.md;集成方式、问题状态与故障排查见 references/workflow-integration.md。
适用场景:撤销最近提交、回滚某个提交或合并的 PR、恢复指定文件、回滚整个分支,以及执行前先干跑预览。
限制:需干净工作目录;仅支持上述白名单方法与校验规则;具体安装、收费、平台与效果等资料暂未提供。