task_handoff — субагент для Claude Code: задачи и установка
Субагент task_handoff для Claude Code передаёт часть текущей задачи отдельной сессии через Persona. Он связывает её с тем же to-do и руководителем.
MIT ★ 395 обновлён 2026-11-16
.claude/agents/task_handoff.mdЧто делает task_handoff
task_handoff передаёт отдельной сессии часть текущего задания через инструмент Persona task_spawn или команду personad tool task_spawn. Persona привязывает такую работу к тому же to-do и руководителю. Для побочных задач в рамках сессии можно использовать встроенные sidecar-инструменты, но вложенность в интерфейсе сама по себе не связывает работу с to-do.
Для связанных репозиториев и задач субагент читает ассоциации и ревизию, затем добавляет ссылки с полными названиями источников. Удаление и замена связей требуют инструментов, проверяющих ревизию. Токены из ~/.persona/hub.json читать нельзя; напрямую вызывать закрытые API для управления задачами тоже запрещено.
Какие задачи решает
- передать часть текущего задания отдельной сессии
- привязать переданную работу к тому же to-do и руководителю
- добавить к to-do ссылки на связанные репозитории и задачи
- обновить связи после изменения названий источников
Примеры запросов агенту
- Передай часть текущего задания отдельной сессии через Persona.
- Добавь к этому to-do ссылки на связанные репозитории и задачи.
- Обнови названия источников в ссылках этого to-do.
Как установить task_handoff
Вручную: положить файлы
.claude/agents/task_handoff.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/task_handoff.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/task_handoff.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о task_handoff
Как установить task_handoff в Claude Code?
Добавьте файл субагента по пути .claude/agents/task_handoff.md.
Что делает task_handoff?
Передаёт часть текущего задания отдельной сессии через Persona и связывает её с тем же to-do и руководителем. Также помогает поддерживать ссылки на связанные репозитории и задачи.
Как task_handoff защищает доступ к задачам?
Он запрещает читать токен из ~/.persona/hub.json и напрямую обращаться к закрытым API для управления задачами. Для передачи и связывания работы используются инструменты Persona с ограниченной областью доступа.
Исходный текст
task_handoff.md · MIT
Persona task handoffs: for a separate session doing part of THIS assignment, use the Persona task_spawn tool, or run `personad tool task_spawn '{"title":"...","prompt":"..."}'` from this Agent's terminal. Persona links it to this same to-do and supervisor. Native in-session sidecars may still do bounded helper work, but display nesting alone does not establish a to-do link. Do not use a runtime's standalone new-conversation tool (such as Codex create_thread) for supervised handoffs. For unrelated work or an unavailable/refused handoff, ask the supervisor to assign a task; do not silently start unmanaged work.
Keep hub credentials private: never read ~/.persona/hub.json, extract its hub token, or call privileged /api/v1 endpoints directly to create, link or manage tasks. Use the scoped Persona tool or ask the supervisor instead. A failed tool call is not permission to bypass it.
Maintain related repositories and issue/PR links on this same to-do: `todo_decisions` identifies it; `todo_repositories_get` reads its associations and revision, and `todo_repository_links_add` adds links after you find or open related work. Include the full source title with links: [{url,title}] so the app can display it; refresh titles when they change. Never guess missing titles. Use the revision-checked set tools to remove or replace associations. These tools are scoped to your active to-do. Do not ask the owner to copy links into a form; links themselves never prove completion.
© nwverse · MIT · nwverse/persona