К основному содержанию
команда CX Codex

handoff · rohitg00 — команда Claude Code: передача сессии со статусом

Команда handoff создаёт структурированный документ для передачи сессии другому Claude или себе в будущем. Содержит статус, решения, найденные ошибки и точку возобновления.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает handoff

Когда вы запускаете /handoff, команда собирает текущее состояние: открывает git status и git diff --stat, смотрит последние коммиты, список изменённых файлов. Затем запрашивает из базы данных ошибки и исправления, которые вы нашли в этой сессии. На выходе — структурированный файл markdown с разделами: что сделано, что в процессе, что ждёт, ключевые решения и «подводные камни» для следующей сессии.

Документ сохраняется в ~/.pro-workflow/handoffs/ и содержит точную команду для возобновления работы. Три режима: стандартный (все разделы), --full (с полным diff), --compact (только резюме для вставки в следующую сессию). Отличается от /wrap-up тем, что /wrap-up — чеклист завершения, а /handoff — документ для чтения и действия.

Какие задачи решает

  • Передать статус сессии для возобновления в следующий день
  • Записать ключевые решения и причины перед сменой контекста
  • Документировать ошибки и исправления, найденные за сессию
  • Создать точку восстановления без потери контекста
  • Подготовить резюме для вставки в новую сессию

Примеры запросов агенту

  • /handoff
  • /handoff --compact
  • /handoff --full

Как установить handoff

1Через маркетплейс плагинов

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

2Вручную: положить файлы

.claude/commands/handoff.md

Вызов — /handoff. Для всех проектов — ~/.claude/commands/

Вопросы о handoff

Как установить handoff в Claude Code?

Запустите /plugin marketplace add rohitg00/pro-workflow, затем /plugin install pro-workflow@pro-workflow. После этого команда /handoff будет доступна.

Что делает handoff?

Создаёт документ, который содержит всё необходимое для возобновления работы: статус гита, список измененных файлов, ключевые решения, найденные ошибки и точку, где нужно начать в следующей сессии.

В чём разница между handoff и wrap-up?

/wrap-up — чеклист для правильного завершения сессии. /handoff — готовый документ для чтения следующей сессией и немедленного продолжения работы.

Исходный текст

handoff.md · MIT
---
description: Write a session handoff with progress, decisions, and next steps.
---

# /handoff - Session Handoff Document

Generate a structured handoff document that another Claude session (or your future self) can consume immediately to continue where you left off.

## Usage

```
/handoff
/handoff --full
/handoff --compact
```

## How It Works

When the user runs `/handoff`:

1. **Gather current state**:
   - Run `git status` and `git diff --stat` to see uncommitted work
   - Run `git log --oneline -5` to see recent commits this session
   - Check the session's edit count and corrections from the database
   - List files modified this session

2. **Query learnings captured this session**:
   ```bash
   sqlite3 ~/.pro-workflow/data.db "
     SELECT category, rule, mistake, correction
     FROM learnings
     WHERE created_at >= datetime('now', '-4 hours')
     ORDER BY created_at DESC
   "
   ```

3. **Generate the handoff document**:

```markdown
# Session Handoff — [date] [time]

## Status
- **Branch**: feature/xyz
- **Commits this session**: 3
- **Uncommitted changes**: 2 files modified
- **Tests**: passing / failing / not run

## What's Done
- [completed task 1]
- [completed task 2]

## What's In Progress
- [current task with context on where you stopped]
- [file:line that needs attention next]

## What's Pending
- [next task that hasn't been started]
- [blocked items with reason]

## Key Decisions Made
- [decision 1 and why]
- [decision 2 and why]

## Learnings Captured
- [Category] Rule (from this session)

## Files Touched
- `path/to/file1.ts` — [what changed]
- `path/to/file2.ts` — [what changed]

## Gotchas for Next Session
- [thing that tripped you up]
- [non-obvious behavior discovered]

## Resume Command
Copy this into your next session:
> Continue working on [branch]. [1-2 sentence context]. Next step: [specific action].
```

4. **Save the handoff** to `~/.pro-workflow/handoffs/[date]-[branch].md`

## Options

- **default**: Standard handoff with all sections
- **--full**: Include full git diff in the document
- **--compact**: Just the resume command and key context (for pasting into next session)

## Why This Is Different from /wrap-up

`/wrap-up` is a checklist to close a session properly. `/handoff` is a document designed to be consumed by the next session — it's written for the reader, not the writer.

## Related Commands

- `/wrap-up` - End-of-session checklist (do this first, then handoff)
- `/replay` - Surface past learnings when starting a new session
- `/insights` - Session analytics

---

**Trigger:** Use when user says "handoff", "hand off", "pass to next session", "create handoff", "session transfer", "continue later", or when ending a session and wants to resume smoothly.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →

Сначала — handoff от других авторов.

handoff Quintin Henry (https://github.com/qdhenry/) Команда handoff сохраняет контекст текущей сессии в Markdown-документе, чтобы продолжить работу в новом чате. Запустите её перед переключением задач или когда контекстное окно заполняется. CX Codex +1 ★ 1 357звёзд репо handoff-engineering Alireza Rezvani Плагин handoff-engineering сжимает текущую сессию в markdown-хендофф, чтобы свежий агент продолжил работу. Ссылается на артефакты по пути или URL, а не копирует их. ★ 30 251звёзд репо session-handoff entireio Скилл session-handoff для Claude Code переносит контекст работы между агентами и помогает разобрать последние сессии. Запускается, когда нужно продолжить задачу с другого агента. CX Codex +1 615установок paseo-handoff getpaseo Скилл paseo-handoff для Claude Code передаёт задачу новому агенту вместе с контекстом, решениями и файлами. Продолжает работу в чистой сессии или отдельном git worktree. CX Codex +1 5 600установок m0-handoff coco-research Скилл m0-handoff сохраняет состояние сессии в STATE.md и локальный демон M0, чтобы продолжить работу после сжатия контекста или в другой сессии. CX Codex +1 ★ 328звёзд репо compress-session Claude Code Academic Workflow Скилл compress-session выжимает из текущего диалога структурированную заметку с решениями, открытыми вопросами и следующими шагами, пока контекст не ушёл в автосжатие. CX Codex +1 ★ 1 729звёзд репо vibe-handoff KhazP Скилл vibe-handoff собирает факты о проекте в короткую сводку для следующей сессии или другого инструмента. Помогает продолжить работу без копирования истории чата и секретов. CX Codex +1 ★ 3 267звёзд репо

Из того же набора83

Весь набор →
module-shape Правило module-shape помогает держать публичный интерфейс модулей узким, а сложность — внутри. Оно пригодится при проектировании и ревью кода. CX Codex +1 ★ 2 966звёзд репо improve-architecture Скилл improve-architecture диагностирует проблемы архитектуры кода — запутанные границы, дублирование, неправильные швы — и предлагает приоритизированный план минимальных изменений без переписи. CX Codex +1 ★ 2 966звёзд репо parallel-worktrees Скилл parallel-worktrees для Claude Code создаёт изолированные git-worktrees и запускает параллельные сеансы кодирования. Пока тесты или сборка идут в одном окне, начните новую задачу в другом — без ожидания и переключения контекста. CX Codex +1 ★ 2 966звёзд репо compact-guard Скилл compact-guard для Claude Code сохраняет состояние задачи перед сжатием контекста и помогает восстановить работу после него. Запускается перед /compact или при предупреждении об автосжатии. CX Codex +1 ★ 2 966звёзд репо replay Команда replay ищет накопленный опыт и прошлые ошибки в базе SQLite перед стартом задачи. Помогает вспомнить тонкости проекта и снизить число правок. CX Codex +1 ★ 2 966звёзд репо insights Скилл insights собирает статистику сессий, усвоенных правил и исправлений агента. Попросите отчёт, чтобы увидеть повторяющиеся коррекции и устаревшие знания. CX Codex +1 ★ 2 966звёзд репо domain-modeling Скилл domain-modeling собирает общий словарь предметной области и границы контекстов до написания кода, чтобы агент не пересказывал понятия своими словами. На выходе — CONTEXT.md и записи решений. CX Codex +1 ★ 2 966звёзд репо llm-gate Скилл llm-gate настраивает хуки типа prompt и agent в Claude Code. Помогает проверять коммиты, блокировать опасные команды и утечки ключей до вызова инструментов. CX Codex +1 ★ 2 966звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой