В шаблонах рабочих процессов Claude шаблон передачи задач: разделение на два файла против сводки одного документа

Длительные сессии с Claude ухудшаются из-за потери контекста. Handoffs решают эту проблему, сжимая ключевую информацию в документ и запуская нового агента. В сообществе сейчас обсуждаются две реализации: навык /handoff от Мэтта Покока и альтернативный подход с разделением на два файла, используемый в мультиагентном фреймворке APM.

Навык Handoff от Мэтта Покока

Навык Покока сжимает разговор в один документ. Он ссылается на существующие артефакты вместо их повторного изложения, и следующий агент продолжает с этого момента. Также он позволяет переключаться между тредами: /grill-with-docs → /handoff → /prototype → /handoff обратно. Репозиторий доступен по адресу mattpocock/skills.

Подход с разделением на два файла (фреймворк APM)

Альтернативный подход, встроенный в мультиагентный фреймворк APM для Claude Code еще в мае 2025 года, разделяет handoff на два артефакта:

• Файл постоянного повествования — записывает, что было сделано, принятые решения и почему. Он хранится в проекте и оставляет долговременный след.
• Временный промпт — указывает новому агенту, как восстановить контекст из кодовой базы и файла постоянного повествования.

Ключевое отличие: новый агент восстанавливается из устойчивого состояния проекта (кодовая база + повествование), а не только из сжатого чата. Сохранение повествования также делает его видимым при участии нескольких агентов, позволяя отслеживать, какой агент работает на основе резюме, а какой — из первых рук. Это упрощает управление пробелами в контексте.

Автор открыл вопрос в репозитории Покока с этими идеями: mattpocock/skills#235.

Ключевые вопросы

• Достаточно ли одного сжатого документа для handoffs?
• Или разделение на два файла (постоянное повествование + временный промпт) обеспечивает лучшее восстановление контекста и отслеживание нескольких агентов?

Обсуждение продолжается. Оба подхода valid в зависимости от того, нужен ли вам быстрый рестарт или длительные мультиагентные рабочие процессы с управлением пробелами в контексте.