handoff-engineering — плагин для Claude Code: передача сессии
Сжимает текущую сессию в markdown-хендофф, чтобы свежий агент продолжил работу. Ссылается на артефакты по пути или URL, а не копирует их.
/plugin marketplace add alirezarezvani/claude-skills
/plugin install handoff-engineering@claude-code-skillsЧто делает handoff-engineering
Плагин собирает документ о состоянии разговора: что сделано, что дальше, какие скиллы понадобятся в следующей сессии. Внутри три Python-скрипта на стандартной библиотеке. handoff_template_generator.py делает каркас под конкретный фокус следующей сессии, artifact_deduplicator.py ищет в черновике куски, которые лучше заменить ссылкой, skill_recommender.py подбирает скиллы по содержимому хендофф-документа.
Есть агент-персона cs-handoff-author и слэш-команда /cs-handoff для генерации в один заход. Правило «не дублировать» взято у Matt Pocock под MIT и сохранено дословно: PRD, планы, ADR, issue и коммиты упоминаются путём или ссылкой. Поэтому документ остаётся коротким и не расходится с исходниками.
Скрипты запускаются через python, отдельной установки зависимостей не требуется. Файл сохраняется по пути от mktemp -t handoff-XXXXXX.md, и перед записью его нужно прочитать. Если передать аргументы, они трактуются как описание фокуса следующей сессии.
Какие задачи решает
- передать работу свежему агенту без пересказа всей истории
- собрать каркас хендофф-документа под конкретную задачу
- найти в черновике куски, которые дублируют PRD или план
- подобрать скиллы для следующей сессии по содержимому
- зафиксировать фокус новой сессии одной командой
Примеры запросов агенту
- /cs-handoff ship PR 2
- Сделай хендофф текущей сессии, укажи, какие скиллы понадобятся дальше
- Прогони artifact_deduplicator.py по черновику хендоффа
Как установить handoff-engineering
Через маркетплейс плагинов
/plugin marketplace add alirezarezvani/claude-skills/plugin install handoff-engineering@claude-code-skillsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о handoff-engineering
Как установить handoff-engineering в Claude?
Через маркетплейс: сначала /plugin marketplace add alirezarezvani/claude-skills, затем /plugin install handoff-engineering@claude-code-skills.
Что делает handoff-engineering?
Сжимает текущий разговор в markdown-документ для следующего агента. Артефакты вроде PRD, планов и коммитов он не копирует, а указывает путём или ссылкой.
Чем это отличается от исходного скилла Matt Pocock?
Добавлены три Python-скрипта на стандартной библиотеке, справочные материалы, агент cs-handoff-author и команда /cs-handoff. Дисциплина «без дублирования» сохранена как в оригинале.
Исходный текст
handoff · MIT
# handoff Conversation-handoff document generator. Saves the current state of a conversation so a fresh agent can pick up the work cleanly. ## Attribution **Derived from [Matt Pocock's handoff](https://github.com/mattpocock/skills/tree/main/skills/productivity/handoff)** (MIT). Matt's no-duplication discipline preserved verbatim — handoff docs reference existing artifacts by path/URL, never duplicate them. ## What this adds on top of Matt's original | Addition | Where | Why | |---|---|---| | **3 stdlib Python tools** | `skills/handoff/scripts/` | Template generator (tailored to next-session focus), artifact deduplicator (find references that should replace inline content), skill recommender (which skills next session needs) | | **3 in-depth references** (5+ sources each) | `skills/handoff/references/` | Handoff structure · Deduplication discipline · Skill matching for next session | | **cs-handoff-author persona agent** | `agents/cs-handoff-author.md` | Continuity-focused handoff author with hard rule against duplication | | **`/cs-handoff` slash command** | `commands/cs-handoff.md` | One-shot handoff generation with argument hint | ## Matt's original (preserved) > "Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it). Suggest the skills to be used, if any, by the next session. Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead. If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly." ## Quick start ```bash # Generate a handoff template scaffold tailored to next-session focus python skills/handoff/scripts/handoff_template_generator.py --next-focus "ship PR 2" # Detect artifacts in a handoff draft that could be replaced by references python skills/handoff/scripts/artifact_deduplicator.py path/to/draft-handoff.md # Recommend skills for the next session based on handoff content python skills/handoff/scripts/skill_recommender.py path/to/handoff.md ``` ## License MIT (matching Matt's upstream).
© Alireza Rezvani · MIT · alirezarezvani/claude-skills