AgentSkillsCN

create-handoff

保存会话状态，以便后续恢复。适用于以下场景： - 用户说“今天就到这里了”、“结束本次会话”、“保存状态”； - 上下文即将达到上限（80% 以上）； - 用户准备短暂休息； - 在进行上下文压缩之前； - 用户提到“交接工作”、“暂停手头任务”、“收尾处理”。

SKILL.md
--- frontmatter
name: create-handoff
description: |
  Save session state for later resumption. Use when:
  - User says "done for today", "ending session", "save state"
  - Context is getting full (80%+)
  - User is taking a break
  - Before context compaction
  - User mentions "handoff", "pause work", "wrapping up"

Create Session Handoff

Save current session state for seamless resumption.

Usage

bash
bash ~/.claude/scripts/create-handoff.sh

Or use the native command:

code
/create-handoff

What Gets Saved

The handoff file includes:

  • •Current task: What you're working on
  • •Progress: What's been completed
  • •Decisions made: Key choices and rationale
  • •Files modified: List of changed files
  • •Next steps: What remains to be done
  • •Context: Important information to remember
  • •Learnings: Patterns discovered in session

Handoff Location

code
~/.claude/handoffs/
├── project-name-2024-01-15-1430.md
├── project-name-2024-01-14-0900.md
└── ...

When to Create Handoff

  1. •End of work session - Before closing Claude Code
  2. •Context at 80%+ - Before auto-compaction
  3. •Taking a break - Preserve state for later
  4. •Switching tasks - Save before context switch
  5. •Before compacting - Auto-triggered by PreCompact hook

Auto-Handoff

The setup automatically creates handoffs:

  • •Before context compaction (PreCompact hook)
  • •At session end (SessionEnd hook)

Output

Confirms:

  • •Handoff file created
  • •Location of file
  • •Key information saved

Resume Later

To resume from a handoff:

code
/resume-handoff

This loads the most recent handoff for the current project.