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

handoff-doc — скилл для Claude Code: что делает и как установить

Скилл handoff-doc для Claude Code фиксирует контекст задачи в отдельный файл перед сбросом сессии или передачей работы. Документ помогает продолжить процесс без чтения всей истории чата.

MIT ★ 741 обновлён 2026-11-11

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

Что делает handoff-doc

Агент собирает данные не из переписки, а из реальных источников: проверяет git status, историю коммитов ветки, последний git diff, результаты тестов и открытые пуллреквесты. Если факт нельзя подтвердить выводом команд, он помечается как unverified.

Итоговый файл сохраняется в репозитории (например, docs/handoff/<task>.md). Шаблон включает цель задачи, принятые и отклонённые решения, жёсткие ограничения, статус проверок и список файлов. Перед коммитом агент запрашивает подтверждение.

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

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

  • зафиксировать состояние задачи перед очисткой контекста сессии
  • передать незавершённую задачу другому разработчику или новому агенту
  • записать отклонённые подходы с причинами отказа, чтобы не повторять ошибки
  • собрать статус тестов и проверок из git status и консольных логов

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

  • Подготовь handoff-doc для текущей задачи перед сбросом контекста
  • Собери brief по ветке фичи и запиши в docs/handoff
  • Напиши прогресс-док по задаче с результатами тестов и следующими шагами

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

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

/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stack

Команда ставит плагин ronny целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add MiniMax-AI/mcode-stack --skill handoff-doc -a claude-code

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

~/.claude/skills/handoff-doc/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/handoff-doc/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о handoff-doc

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

Выполните /plugin marketplace add MiniMax-AI/mcode-stack, затем /plugin install ronny@mcode-stack. Также доступна установка через npx skills add MiniMax-AI/mcode-stack --skill handoff-doc -a claude-code.

Что делает handoff-doc?

Скилл формирует компактный документ передачи контекста на основе состояния git, логов сборки и тестов, чтобы новый диалог или коллега продолжили задачу без чтения истории чата.

Что нужно для работы handoff-doc?

Скилл использует стандартные команды git и файлы проекта; внешние платные сервисы или API-ключи не требуются.

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

SKILL.md · MIT
---
name: handoff-doc
description: Write a hand-off document so a fresh session or another person can continue the current task without the chat history. Use when switching tasks, after several compactions, before clearing a session, or when asked to write a handoff, brief, or progress doc.
---

# Hand-off Doc

Important state should not live only in the context window. A short, readable
hand-off doc lets you clear the session, start a new one, or pass the work to
someone else, and continue with exactly what you consider important.

Companion to MCode Engineering Notes 01 and 03.

## 1. Gather from real sources

Before writing, check the actual state instead of relying on memory of the
conversation:

- `git status`, `git log` for the branch, and the current diff.
- The test or build commands that were run and their latest real results.
- Any existing design, progress or todo files in the repository.
- Open issues, PRs or review comments linked to the task.

If something cannot be verified, mark it "unverified".

## 2. Write the doc

Save it in the repository (for example `docs/handoff/<task>.md`) or wherever
the project keeps working notes. Ask before committing it. Use this template:

```markdown
# Hand-off: <task>

Updated: <date>   Branch: <branch>   Last commit: <short sha>

## Goal
One or two sentences. What "done" looks like, and the acceptance criteria.

## Decisions made
- <decision> - because <reason>

## Constraints to keep
- <constraint the next session must not break, e.g. "do not change the public API">

## Ruled out
- <approach> - why it was dropped (so nobody tries it again)

## Current state
- Done: ...
- In progress: ...
- Verified by: <command> -> <result>

## Next steps
1. <the very next concrete action>
2. ...

## Watch out for
- Known pitfalls, flaky tests, environment quirks.

## Pointers
- Key files, functions, issues, PRs.
```

Keep it short. It is a brief, not a transcript. Leave out debugging
narratives and tool output that can be reproduced.

## 3. Hand over

- Tell the user where the doc is.
- In the new session, reference the doc first (for example by mentioning its
  path) and ask the agent to restate the goal and the next step before it
  starts.
- Update the same doc at each milestone instead of creating new ones.

## Output

The path of the doc and a three-line summary: goal, current state, next step.

© Ronny (MiniMax Code team) · MIT · MiniMax-AI/mcode-stack

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
handoff prathamdby Скилл handoff для Claude Code сохраняет контекст работы в файл или продолжает задачу по готовой передаче. Он фиксирует текущие факты, проверяет состояние проекта и выбирает следующую задачу. CX Codex +1 719установок session-handoff softaworks Скилл session-handoff создаёт документы передачи контекста между сессиями агента. Помогает при переполнении окна контекста и долгих проектах. CX Codex +1 4 300установок vibe-handoff KhazP Скилл vibe-handoff собирает факты о проекте в короткую сводку для следующей сессии или другого инструмента. Помогает продолжить работу без копирования истории чата и секретов. CX Codex +1 ★ 3 267звёзд репо backend-to-frontend-handoff-docs davila7 Скилл backend-to-frontend-handoff-docs собирает API-хендофф-документ для фронтенд-разработчиков: эндпоинты, DTO, валидация и граничные случаи в одном markdown-файле. CX Codex +1 164установок resume-handoff parcadei Скилл resume-handoff для Claude Code читает хендофф-документ, сверяет его с текущим состоянием репозитория и предлагает план продолжения. Восстанавливает контекст прерванной сессии. CX Codex +1 486установок handoff-continue Quintin Henry (https://github.com/qdhenry/) Команда handoff-continue собирает отчёт о текущей работе и запускает новую сессию Claude в панели Zellij, подсунув ей этот отчёт на входе. CX Codex +1 ★ 1 357звёзд репо

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

Весь набор →
youfang Плагин youfang для Claude Code превращает схемы архитектуры и процессов в интерактивные HTML-презентации с эффектом Magic Move. Генерирует один автономный файл с плавными переходами блоков. CX Codex ★ 741звёзд репо req-tpm Плагин req-tpm для Claude Code ведёт требования от сбора до проверки результата. Агент помогает зафиксировать ожидаемый эффект, подготовить решение и отслеживать ход работы. CX Codex ★ 741звёзд репо jiachen Плагин jiachen для Claude Code проверяет ветки и PR через MCode Review. Запускается по просьбе агента или в CI GitHub и GitLab; блокирующие замечания требуют доказанного пути сбоя. CX Codex ★ 741звёзд репо ronny Плагин ronny для Claude Code включает скиллы для ревью кода, работы с агентами и проверки их результатов. Он подключается к запросам на ревью изменений, делегирование задач и аудит рабочих процессов агента. CX Codex ★ 741звёзд репо review-capacity-check Скилл review-capacity-check для Claude Code проверяет очередь агентских результатов перед новым запуском. Он запускается перед параллельной сессией и на еженедельном разборе. CX Codex +1 ★ 741звёзд репо taste-to-checks Скилл taste-to-checks для Claude Code превращает повторяющиеся замечания к коду в тесты, линтеры, хуки, шаги CI или правила проекта. Он срабатывает после повторного промаха в ревью. CX Codex +1 ★ 741звёзд репо trajectory-review Скилл trajectory-review для Claude Code разбирает путь агента от запроса до результата. Срабатывает после сбоя, завершённой задачи или смены результата eval. CX Codex +1 ★ 741звёзд репо harness-experiment Скилл harness-experiment для Claude Code организует управляемые эксперименты с изменениями в агенте. Запускается при настройке промптов, инструментов или структуры субагентов для оценки влияния изменений. CX Codex +1 ★ 741звёзд репо

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

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