用途:当某次改动出错需要回退时,把仓库文件恢复到之前的 Octopus 检查点,同时尽量保留已积累的经验教训。原为 Claude Code 设计,后适配 Codex CLI;在 Codex 中交叉引用使用已安装技能名,而非 /octo:* 斜杠命令。
主要能力:列出可用检查点(git tag -l "octo-checkpoint-*" --sort=-creatordate);回滚到指定标签;回滚前先创建安全备份检查点;保护 .octo/LESSONS.md 不被回滚;回滚后更新 .octo/STATE.md 历史;回滚前显示受影响文件预览。
使用方式:用户给出 list、查看检查点或无参数时进入 LIST 模式,展示检查点表格及用法 /octo:rollback <tag-name>。给出 octo-checkpoint-* 标签名时进入 ROLLBACK 模式:先验证标签存在,再用 git diff --name-status HEAD $CHECKPOINT_TAG 预览将改动的文件,要求用户精确输入 ROLLBACK 确认;确认后创建安全标签 octo-checkpoint-pre-rollback-$TIMESTAMP,保存并恢复 .octo/LESSONS.md,执行 git checkout $CHECKPOINT_TAG -- . 恢复文件(不移动 HEAD、不改分支、保留提交历史),随后可 git add -A && git commit -m "chore: rollback to $CHECKPOINT_TAG" 提交。检查点标签格式为 octo-checkpoint-{type}-{timestamp},type 可为 post-discover、post-define、post-develop、post-deliver、pre-rollback、manual。
限制与安全:必须显式确认才执行;不得跳过安全检查点;不得回滚 LESSONS.md;禁止使用 git reset --hard、回滚后强推、删除检查点标签。若未找到检查点或标签不存在则停止,不继续操作。