القائمة
Save session state to ledger file for continuity across crashes, context switches, or /clear + reload cycles.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill session-checkpointيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | session-checkpoint |
| description | Save session state to ledger file for continuity across crashes, context switches, or /clear + reload cycles. |
| allowed-tools | Read Write |
Audience: Agents and developers needing to preserve session state during long-running workflows.
Goal: Snapshot current session state to a ledger file for crash recovery, context refresh, and cross-session continuity.
Key insight: /clear + ledger reload provides fresh context with full signal preservation, avoiding the cumulative degradation of repeated /compact cycles.
Requires session.ledger: true in .agents.yml:
session:
ledger: true
ledger_path: .agents/session_ledger.md # optional, defaults to .agents/session_ledger.md
Note: The ledger is per-worktree (ephemeral session state). Handoffs go to main worktree (permanent, for Skill("learn")).
SESSION = config_read("session", "{}")
If session.ledger is false or missing:
Checkpoint skipped - session.ledger not enabled in .agents.ymlUse session.ledger_path from config, or default to .agents/session_ledger.md.
Ensure the directory exists:
mkdir -p .agents
From the provided context, extract:
UNCONFIRMED if uncertain)Write to the ledger file using this format:
# Session Ledger
_Last updated: <timestamp>_
## Goal
<goal and success criteria>
## Constraints/Assumptions
- <constraint 1>
- <constraint 2>
## Key Decisions
- <decision 1>
- <decision 2>
## State
### Done
- <completed item 1>
- <completed item 2>
### Now
<current focus>
### Next
<planned next step>
## Open Questions
- <question 1>
- <question 2> `UNCONFIRMED`
## Working Set
- Files: <key files>
- IDs: <relevant IDs>
- Commands: <useful commands>
Return a brief confirmation:
Checkpoint saved to .agents/session_ledger.md
- Goal: <brief goal>
- State: <done count> done, now: <current>, next: <next>
/clear + ledger reload/handoffOther agents or skills can invoke checkpointing:
Before starting major refactor, apply `session-checkpoint` skill to save current state.
After completing each major step, apply `session-checkpoint` skill with current progress.
If context usage exceeds 70%, apply `session-checkpoint` skill before continuing.
When resuming after /clear with a ledger file:
UNCONFIRMED needs verificationMark assumptions as UNCONFIRMED when:
Prefer /clear + ledger reload over multiple /compact cycles:
| Approach | Context Quality | Signal Loss |
|---|---|---|
Single /compact | Good | Minimal |
Multiple /compact cycles | Degraded | Cumulative - each cycle loses detail |
/clear + ledger reload | Fresh | None - ledger preserves full signal |
Guideline: After 2-3 compactions in a session, checkpoint to ledger and /clear for fresh context with preserved state.
| Tool | Purpose | Persistence | Trigger |
|---|---|---|---|
session-checkpoint | Crash recovery, quick state save | File (.agents/session_ledger.md) | Skill-triggered |
/handoff | Cross-session continuity | File (main worktree .agents/handoffs/) | User/ship-triggered |
Tasks | Session task tracking | File (~/.claude/tasks/) | Agent-triggered |
Use session-checkpoint for:
Use /handoff for: