AgentSkillsCN

Skill Handoff

技能接手

SKILL.md

Session Handoff Skill

This skill creates structured handoff documents for session continuity.

Usage

Invoke with /handoff followed by optional arguments:

  • /handoff - Create handoff for current session
  • /handoff --summary - Brief summary only
  • /handoff --file <path> - Save to specific file
  • /handoff --task "<description>" - Include specific task context

Workflow

1. Gather Session Context

  • Review conversation history
  • Identify files modified
  • Note decisions made
  • Capture current task state

2. Capture State

bash
# Run these commands to gather context
git status
git diff --stat
git log -3 --oneline

3. Generate Handoff Document

Output Format

Save to .handoff/YYYY-MM-DD_HH-MM.md:

markdown
# Session Handoff

**Date**: [timestamp]
**Duration**: [approximate session length]
**Branch**: [current git branch]

## Summary
[2-3 sentence overview of what was accomplished]

## Task Context
**Original Request**: [what the user asked for]
**Current State**: [in-progress / blocked / completed]

## What Was Done
- [Completed item 1]
- [Completed item 2]
- [Completed item 3]

## Files Modified
- `path/to/file1.ts` - [brief description of changes]
- `path/to/file2.ts` - [brief description of changes]

## Decisions Made
- [Decision 1]: [rationale]
- [Decision 2]: [rationale]

## Current Blockers
- [Blocker if any, or "None"]

## Next Steps
1. [Immediate next action]
2. [Following action]
3. [Future consideration]

## Context for Next Session
[Any important context the next session needs to know]

## Commands to Resume
```bash
# Suggested commands to get started
cd [project-directory]
git status
[relevant command]
code

## Best Practices

### What to Include
- Specific file paths and line numbers
- Error messages encountered
- URLs or references consulted
- Test results and their meaning

### What to Avoid
- Excessive detail on completed work
- Speculation about future approaches
- Personal opinions not relevant to task

## Storage

Default location: `.handoff/` directory in project root
- Creates directory if it doesn't exist
- Uses timestamped filenames
- Keeps last 10 handoffs, archives older ones

## Integration

Works well with:
- `/pickup` - Resume from handoff
- `/ship` - Complete and handoff