handoff-doc — скилл для Claude Code: что делает и как установить
Скилл handoff-doc для Claude Code фиксирует контекст задачи в отдельный файл перед сбросом сессии или передачей работы. Документ помогает продолжить процесс без чтения всей истории чата.
MIT ★ 741 обновлён 2026-11-11
/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stackЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/handoff-doc/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/handoff-doc/
1Через Skills CLI (Vercel)
npx skills add MiniMax-AI/mcode-stack --skill handoff-doc -a codex2Вручную: положить файлы
.agents/skills/handoff-doc/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add MiniMax-AI/mcode-stack --skill handoff-doc -a cursor2Вручную: положить файлы
.cursor/skills/handoff-doc/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install MiniMax-AI/mcode-stack stacks/ronny/skills/handoff-doc2Вручную: положить файлы
.github/skills/handoff-doc/SKILL.md1Через Skills CLI (Vercel)
npx skills add MiniMax-AI/mcode-stack --skill handoff-doc -a gemini-cli2Командой платформы
gemini skills install https://github.com/MiniMax-AI/mcode-stack --path stacks/ronny/skills/handoff-docВручную: положить файлы
.devin/skills/handoff-doc/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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