Agent Skills
› NeverSight/learn-skills.dev
› checkpoint-manager
checkpoint-manager
GitHub管理代码状态快照，支持创建、回滚及恢复检查点。用于自主编码中的安全实验与风险控制，通过保存Git状态和上下文信息，确保在操作失败时能可靠地恢复到先前稳定状态。
Trigger Scenarios
需要创建代码状态快照
执行高风险操作前
需要回滚到特定版本
实现安全实验机制
Install
npx skills add NeverSight/learn-skills.dev --skill checkpoint-manager -g -y
SKILL.md
Frontmatter
{
"name": "checkpoint-manager",
"layer": "verification-recovery",
"version": "1.0.0",
"category": "autonomous-coding",
"description": "State snapshots and rollback for safe experimentation. Use when creating checkpoints, rolling back changes, managing recovery points, or implementing safe experimentation."
}
Checkpoint Manager
Creates and manages state checkpoints for safe rollback during autonomous coding.
Quick Start
Create Checkpoint
from scripts.checkpoint_manager import CheckpointManager
manager = CheckpointManager(project_dir)
checkpoint = await manager.create_checkpoint(
name="before-refactor",
description="State before major refactoring"
)
Rollback to Checkpoint
await manager.rollback(checkpoint.id)
# or rollback to latest
await manager.rollback_to_latest()
Checkpoint Workflow
┌─────────────────────────────────────────────────────────────┐
│ CHECKPOINT WORKFLOW │
├─────────────────────────────────────────────────────────────┤
│ │
│ CREATE CHECKPOINT │
│ ├─ Capture git state (commit hash, dirty files) │
│ ├─ Snapshot feature list │
│ ├─ Save progress file state │
│ ├─ Record context (session, tokens) │
│ └─ Store checkpoint metadata │
│ │
│ RISKY OPERATION │
│ ├─ Attempt operation │
│ ├─ If success → Continue │
│ └─ If failure → Rollback to checkpoint │
│ │
│ ROLLBACK │
│ ├─ Load checkpoint data │
│ ├─ Git reset to checkpoint commit │
│ ├─ Restore feature list │
│ ├─ Restore progress file │
│ └─ Clean up temporary files │
│ │
└─────────────────────────────────────────────────────────────┘
Checkpoint Structure
{
"id": "checkpoint-20250115-103000",
"name": "before-refactor",
"description": "State before major refactoring",
"timestamp": "2025-01-15T10:30:00",
"git_state": {
"commit_hash": "abc1234",
"branch": "main",
"dirty_files": ["src/app.ts"]
},
"feature_state": {
"current": "auth-003",
"completed": ["auth-001", "auth-002"],
"snapshot_path": ".claude/checkpoints/checkpoint-xxx/feature_list.json"
},
"context": {
"session_number": 5,
"token_usage": 45000
}
}
Checkpoint Types
| Type | Trigger | Retention |
|---|---|---|
| Automatic | Before risky operations | Last 5 |
| Manual | User/agent request | Until deleted |
| Feature | After feature complete | Permanent |
| Session | Start of session | Last 3 |
Integration Points
- error-recoverer: Triggers rollback on failures
- coding-agent: Creates checkpoints before changes
- autonomous-loop: Manages checkpoint lifecycle
- context-state-tracker: Provides state to checkpoint
References
references/CHECKPOINT-STRATEGY.md- Strategy guidereferences/ROLLBACK-PROCEDURES.md- Rollback details
Scripts
scripts/checkpoint_manager.py- Core managerscripts/git_snapshot.py- Git state capturescripts/state_snapshot.py- Feature/progress capturescripts/rollback_handler.py- Rollback execution
Version History
- e0220ca Current 2026-07-05 23:08
