ac-checkpoint-manager

AC Checkpoint Manager 用于在自主开发过程中管理检查点，以实现安全回滚。

用途

创建和管理检查点，使系统能够回滚到已知的良好状态，从而在自主运行期间提供安全保障。

快速开始

from scripts.checkpoint_manager import CheckpointManager

manager = CheckpointManager(project_dir) checkpoint = await manager.create_checkpoint("before-refactor") await manager.restore_checkpoint(checkpoint.id)

检查点类型

• Auto：在关键节点自动创建
• Manual：在明确请求时创建
• Feature：在每个功能完成后创建
• Session：在会话边界创建

检查点结构

.claude/checkpoints/ ├── checkpoint-20240115-100000/ │ ├── metadata.json │ ├── feature_list.json │ ├── execution-state.json │ └── git-ref.txt ├── checkpoint-20240115-110000/ │ └── ...

自动检查点触发点

• 开始新功能之前
• 完成功能之后
• 执行高风险操作之前
• 上下文压缩时

工作流

1. CREATE → 快照当前状态
2. STORE → 保存文件和 git 引用
3. VALIDATE → 验证检查点完整性
4. （回滚时）
5. RESTORE → 从检查点恢复
6. VERIFY → 确认恢复结果

集成

• 被 ac-state-tracker 用于状态恢复
• 被 ac-task-executor 在风险操作前使用

API 参考

完整实现请参见 scripts/checkpoint_manager.py。