Agent Skills
› NeverSight/learn-skills.dev
› ac-checkpoint-manager
ac-checkpoint-manager
GitHub用于管理开发过程中的检查点，支持创建、恢复和验证状态快照。提供自动与手动多种类型，确保在重构或执行高风险操作前能安全回滚至已知良好状态，保障自主开发的稳定性。
Trigger Scenarios
需要保存当前项目状态以便后续回滚
执行高风险操作前的安全检查点创建
功能模块完成后的状态固化
从之前保存的检查点恢复项目状态
Install
npx skills add NeverSight/learn-skills.dev --skill ac-checkpoint-manager -g -y
SKILL.md
Frontmatter
{
"name": "ac-checkpoint-manager",
"description": "Manage checkpoints for rollback capability. Use when creating save points, rolling back changes, managing recovery points, or restoring previous states."
}
AC Checkpoint Manager
Manage checkpoints for safe rollback during autonomous development.
Purpose
Creates and manages checkpoints that enable rollback to known-good states, providing safety during autonomous operation.
Quick Start
from scripts.checkpoint_manager import CheckpointManager
manager = CheckpointManager(project_dir)
checkpoint = await manager.create_checkpoint("before-refactor")
await manager.restore_checkpoint(checkpoint.id)
Checkpoint Types
- Auto: Created automatically at key points
- Manual: Created on explicit request
- Feature: Created after each feature completion
- Session: Created at session boundaries
Checkpoint Structure
.claude/checkpoints/
├── checkpoint-20240115-100000/
│ ├── metadata.json
│ ├── feature_list.json
│ ├── execution-state.json
│ └── git-ref.txt
├── checkpoint-20240115-110000/
│ └── ...
Auto-Checkpoint Points
- Before starting new feature
- After completing feature
- Before risky operations
- At context compaction
Workflow
1. CREATE → Snapshot current state
2. STORE → Save files and git ref
3. VALIDATE → Verify checkpoint integrity
4. (on rollback)
5. RESTORE → Restore from checkpoint
6. VERIFY → Confirm restoration
Integration
- Used by:
ac-state-trackerfor state recovery - Used by:
ac-task-executorbefore risky operations
API Reference
See scripts/checkpoint_manager.py for full implementation.
Version History
- e0220ca Current 2026-07-05 23:05
