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

engine_handoff — субагент для Claude Code: что делает и как установить

Субагент engine_handoff для Claude Code, управляющий передачей сессии между движками и синхронизацией контекста. Запускается при переключении контекста между движками в ходе сессии.

MIT ★ 395 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/engine_handoff.md
Открыть на GitHub

Что делает engine_handoff

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

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

Для обращения к старым логам скрипт предписывает использовать точечный поиск по ключевым словам через grep, не выгружая целиком объемные файлы транскриптов в активный диалог.

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

  • передавать контекст беседы между движками
  • синхронизировать историю сессии
  • проверять актуальное состояние репозитория
  • читать лог-файлы транскриптов по ключевым словам

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

  • Передай управление сессией через engine_handoff
  • Синхронизируй контекст после смены движка
  • Проверь изменения в рабочем пространстве перед правкой

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

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

.claude/agents/engine_handoff.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы об engine_handoff

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

Поместите файл в .claude/agents/engine_handoff.md.

Что делает engine_handoff?

Субагент управляет передачей контекста и истории сессии при переключении между движками кодинга.

Как субагент разрешает конфликты между историей и кодом?

При расхождении записей в логах и реального состояния рабочего пространства побеждает актуальное состояние файлов.

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

engine_handoff.md · MIT
[Session handoff · internal context]
{{if .Delta -}}
You ({{ctx .To}}) worked on this conversation before; it was handed over to the {{ctx .From}} engine for a while, and now it is switching back to you. Your memory of the conversation from before you left should still be valid; below is a record of what happened while you were away. Merge it into your understanding and continue naturally in the first person. Do not mention this handoff note to the user, and do not mention the engine switch. Before making any change, check the actual workspace state (e.g. git status / git diff / reading the relevant files): when the record, your own memory, and the workspace disagree, the workspace always wins; when you are unsure about something from while you were away, read the real files and code to confirm rather than guessing from the summary.
{{- else -}}
This conversation was previously driven by the {{ctx .From}} engine; from here on you ({{ctx .To}}) continue it. Below is the prior record of this conversation — it is the same conversation between you and the user, so continue naturally in the first person. Do not mention this handoff note to the user, do not mention the engine switch, and do not say things like "according to the handoff summary/record". Before making any change, check the actual workspace state (e.g. git status / git diff / reading the relevant files): when the record conflicts with the workspace, the workspace always wins; when you are unsure about an earlier detail, read the real files and code to confirm rather than guessing from the summary.
{{- end}}
{{- with .Ledger}}{{if or .Files .Commands .Failed}}

== Work ledger (auto-extracted) ==
{{- if .Files}}
Files changed:
{{- range .Files}}
- {{ctx .}}
{{- end}}
{{- end}}
{{- if .Commands}}
Commands (most recent):
{{- range .Commands}}
- {{template "agents/engine_handoff_command" .}}
{{- end}}
{{- end}}
{{- if .Failed}}
Failed attempts:
{{- range .Failed}}
- {{template "agents/engine_handoff_command" .}}
{{- end}}
{{- end}}
{{- end}}{{end}}
{{- if or .Index .Omitted}}

{{if .Delta}}== Earlier progress while you were away =={{else}}== Earlier conversation index (hints only, not a verified summary) =={{end}}
{{- if .Omitted}}
(earlier content omitted)
{{- end}}
{{- range .Index}}
{{if .Reply}}  Reply: {{else}}- {{template "agents/engine_handoff_speaker" .}}: {{end}}{{ctx .Text}}
{{- end}}
{{- end}}
{{- if .Recent}}

{{if .Delta}}== Conversation while you were away =={{else}}== Recent conversation =={{end}}
{{- range $i, $turn := .Recent}}
{{- if $i}}
---
{{- end}}
{{- if or .Text .Images}}
[{{template "agents/engine_handoff_speaker" .}}]
{{- if .Text}}
{{ctx .Text}}
{{- end}}
{{- if .Images}}
({{.Images}} image{{if gt .Images 1}}s{{end}} attached, not carried over)
{{- end}}
{{- end}}
{{- range .Lines}}
{{if eq .Kind "assistant"}}[Assistant]
{{ctx .Text}}
{{- else if eq .Kind "tool"}}[Tool] {{ctx .Tool}}{{if .ID}} (id={{ctx .ID}}){{end}}{{if .Text}}: {{ctx .Text}}{{end}}
{{- else if eq .Kind "result"}}[Tool result{{if .ID}} id={{ctx .ID}}{{end}}; {{if .Failed}}failed{{else}}recorded; verify outcome from result{{end}}]
{{if .Text}}{{ctx .Text}}{{else}}(no text result retained){{end}}
{{- else}}({{.Omitted}} tool calls omitted)
{{- end}}
{{- end}}
{{- end}}
{{- else if .Delta}}

== No new messages while you were away ==
{{- end}}
{{- if .Transcripts}}

== Retrieving earlier verbatim history (use when needed) ==
{{if .Delta}}What happened while you were away{{else}}This conversation's earlier record{{end}} is kept word for word in {{if gt (len .Transcripts) 1}}these transcript files{{else}}this transcript file{{end}} on this computer:
{{- range .Transcripts}}
- {{ctx .Engine}} session {{ctx .Session}}: {{ctx .Path}}
{{- end}}
The record above is only a hint. Retrieve earlier verbatim text only when an earlier detail is actually needed: search the file for keywords and read only around a hit. Each line is one JSON record and some are very long, so print only part of a matching line (e.g. `grep -o '.\{0,200\}<keyword>.\{0,200\}' <file>`). Never read or print a whole file, and never dump the history into the conversation. Retrieved original text outranks this note; when it conflicts with the current workspace, the workspace wins.
{{- end}}

== End of handoff note; the user's new message follows ==

© nwverse · MIT · nwverse/persona

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
handoff rohitg00 Скилл handoff возобновляет последнюю сессию агента для текущей папки и сразу показывает незакрытый вопрос. CX Codex +1 14 400установок paseo-handoff getpaseo Скилл paseo-handoff для Claude Code передаёт задачу новому агенту вместе с контекстом, решениями и файлами. Продолжает работу в чистой сессии или отдельном git worktree. CX Codex +1 5 600установок design-handoff официальный anthropics Скилл design-handoff превращает макет или его описание в спецификацию для разработчиков: размеры, токены, состояния, брейкпоинты, краевые случаи. CX Codex +1 4 000установок slicc-handoff adobe Скилл slicc-handoff для Claude Code передаёт текущую задачу браузерному агенту SLICC или просит его установить скилл из GitHub. Передаёт задачу для продолжения в браузере. CX Codex +1 928установок ce-handoff EveryInc Скилл ce-handoff сохраняет контекст текущей сессии в неизменяемый файл передачи и помогает новому агенту продолжить работу без доступа к прошлой истории. CX Codex +1 857установок session-handoff entireio Скилл session-handoff для Claude Code переносит контекст работы между агентами и помогает разобрать последние сессии. Запускается, когда нужно продолжить задачу с другого агента. CX Codex +1 615установок

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

Весь набор →
worker_supervise Субагент worker_supervise для Claude Code управляет запущенными через task_plan воркерами и разбирает их статусы. Он сверяет результаты с критериями готовности и передаёт решения через task_review. CX Codex ★ 395звёзд репо agents_switch Субагент agents_switch для Claude Code переносит запущенных и остановленных агентов на другой лаунчер за один вызов. Срабатывает по запросу пользователя при контроле лимитов подписки. CX Codex ★ 395звёзд репо standing_actions Субагент standing_actions для Claude Code классифицирует действия, которые разрешает карта подтверждения агента. CX Codex ★ 395звёзд репо agent_send Субагент agent_send для Claude Code отправляет сообщения другому агенту и передаёт ему новую задачу под надзором. Для продолжения работы он может возобновить остановленного агента с прежним контекстом. CX Codex ★ 395звёзд репо agent_start Субагент agent_start для Claude Code запускает отдельного агента в терминале на выбранном компьютере. Он берёт задачу на разработку и возвращает ID новой сессии. CX Codex ★ 395звёзд репо frontend-motion Субагент frontend-motion для Claude Code выполняет задачи по интерфейсам и анимации на веб-клиентах, iOS и Android. Запускается при точечных изменениях интерфейса по готовому заданию. CX Codex ★ 395звёзд репо task_review Субагент task_review для Claude Code проверяет результат делегированной задачи и выбирает вердикт. Он принимает выполненную работу, отправляет пробелы на доработку или передаёт решение владельцу. CX Codex ★ 395звёзд репо task_plan Субагент task_plan для Claude Code формирует и передаёт пользователю план независимых задач для запуска агентов на компьютерах. Запускается при постановке работы, требующей агента или больше нескольких вызовов инструментов. CX Codex ★ 395звёзд репо

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

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