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

long-task — субагент для Claude Code: установка и работа

Субагент long-task для Claude Code ведёт задачи с ожиданием от 5 до 60 минут. Он запускает долгие команды в фоне и передаёт работу дальше после длительной паузы.

Apache-2.0 ★ 262 обновлён 2026-11-17

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

Что делает long-task

Субагент long-task ведёт задачи, где отдельные этапы могут ждать от 5 до 60 минут: моделирование, маршрутизация, рендеринг, компиляция, обучение и эксперименты. Кэш промпта живёт 1 час, параллельно можно запускать любое число задач.

Команды дольше 5 минут он запускает через фоновой режим или nohup, сохраняя логи и файлы результатов. При долгом выполнении он ищет узкое место: загрузку CPU или GPU, последовательные шаги и повторную загрузку, затем использует параллелизм, пакетную обработку или повторное использование ресурсов. Ожидание до 5 минут передаётся обычному агенту.

Если работа может длиться больше часа, субагент оставляет handoff с прогрессом, путями к файлам и следующим шагом, а новый агент продолжает задачу после готовности результата. После примерно 150k токенов контекста он также формирует handoff. В выдаче указывает пути к результатам и итоги проверки.

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

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

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

  • Запусти рендеринг и продолжай работу, пока команда выполняется в фоне.
  • Проведи эксперимент, который займёт больше 5 минут, сохрани лог и файл результата.
  • Если обучение продлится больше часа, подготовь handoff с прогрессом и путями к файлам.

Как установить long-task

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

.claude/agents/long-task.en.md

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

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

Вопросы о long-task

Как установить long-task в Claude Code?

Разместите файл субагента по пути .claude/agents/long-task.en.md.

Что делает long-task?

Он ведёт задачи с ожиданием от 5 до 60 минут, запускает долгие команды в фоне, сохраняет логи и результаты. После длительного ожидания или большого контекста он передаёт продолжение новому агенту через handoff.

Когда long-task передаёт работу другому агенту?

При ожидании дольше часа он завершает текущий этап, сохраняет прогресс, пути к файлам и следующий шаг. Такой же handoff создаётся после примерно 150k токенов контекста.

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

long-task.en.md · Apache-2.0
---
name: long-task
description: Any task expected to wait 5–60 minutes along the way (modeling, routing, rendering, compiling, training, experiments, ...); prompt cache 1 hour. Any number can run at once. Under 5 minutes of waiting use general-purpose; over 1 hour, do not stay waiting: start it in the background, finish, and start a new agent when the result is in.
experimental:
  cacheTtl: 1h
---
You are a long-task subagent. Do what the task asks.
Run any command expected to take over 5 minutes with nohup or in the background (run_in_background), writing a log and result files; continue when the completion notice arrives. Do not sleep-poll.
When a command has run over 5 minutes, first find out why it is slow (CPU/GPU use, one core only, steps run one after another, the same start-up and loading repeated); change what can be parallelized, batched or reused before the next run, without lowering output quality; report the time before and after.
If the wait will be over 1 hour, start it in the background, write a handoff (how far, where the files are, the next step), deliver and finish. Do not wait.
Once the context is past about 150k tokens (a hook reminds you), write a short handoff (how far, where the files are, the next step) and deliver at once; the dispatcher starts a new agent to continue.
In the delivery, give the output file paths and the acceptance results.
<!-- conest:agent long-task (installed by bothouse setup hooks; delete this line and bothouse no longer overwrites or removes this file) -->

© zuiho-kai · Apache-2.0 · zuiho-kai/bothouse

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
long-task-coordinator zhaono1 Скилл long-task-coordinator ведёт многосессионную работу через файл состояния: восстановление после сбоев, явные статусы и честные отчёты о прогрессе. CX Codex +1 691установок long-task-continuation GanyuanRan Скилл long-task-continuation для Claude Code фиксирует контрольные точки и подтверждения в долгих задачах при сбросе контекста или передаче между агентами. Сопровождает многоэтапные рефакторинги. CX Codex +1 ★ 1 450звёзд репо very-long-text-summarization curiositech Скилл very-long-text-summarization для обработки книг, справочников и больших кодбаз через многоуровневое извлечение знаний. Выдаёт карту знаний, а не просто сжатый пересказ. CX Codex +1 210установок long-horizon-prompting guanyang Скилл long-horizon-prompting помогает писать и проверять промпты долгоживущих агентов и многоагентных оркестровок, чтобы они работали автономно и не подменяли решение его подобием. CX Codex +1 188установок nemo-mbridge-perf-moe-long-context NVIDIA Скилл nemo-mbridge-perf-moe-long-context помогает подобрать context parallelism и selective recompute при обучении MoE-моделей на длинных контекстах в Megatron Bridge. CX Codex +1 1 800установок emerging-techniques-long-context Orchestra Research Скилл emerging-techniques-long-context помогает расширять контекстное окно моделей-трансформеров с помощью RoPE, YaRN, ALiBi и интерполяции позиций. Пригодится при обработке текстов длиной от 32k до 128k+ токенов. CX Codex +1 107установок

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

Весь набор →
codemap-inject.en Правило codemap-inject.en для Claude Code подключает карты кодовой базы к задачам субагентов по ключевым словам. Субагент изучает карту перед работой и возвращает новые символы для её обновления. CX Codex +1 ★ 262звёзд репо choice-ask-guard.en Правило choice-ask-guard.en для Claude Code проверяет вопросы агента по уже принятым решениям и задаёт только незакрытые вопросы. CX Codex +1 ★ 262звёзд репо param-source-guard.en Правило param-source-guard.en для Claude Code обязывает указывать источник для всех числовых параметров в коде. Оно проверяет новые лимиты, пороги и окна на наличие комментария с происхождением данных. CX Codex +1 ★ 262звёзд репо wiki-context.en Правило wiki-context.en для Claude Code читает релевантные подсказки из wiki и строки с уроками для текущей сессии. CX Codex +1 ★ 262звёзд репо _head.en Правило _head.en для Claude Code управляет перехватом вызовов инструментов через хуки. Оно запрещает модели обходить блокировки и регламентирует переключение проверок по прямой команде. CX Codex +1 ★ 262звёзд репо dispatch-review-guard.en dispatch-review-guard.en — правило для Claude Code, которое проверяет отметки ревью перед отправкой задачи субагенту. CX Codex +1 ★ 262звёзд репо bash-guard.en Правило bash-guard.en для Claude Code запрещает опасные команды терминала и настраивает таймауты фоновых задач. CX Codex +1 ★ 262звёзд репо model-switch Скилл model-switch для Claude Code управляет выбором модели и параметрами рассуждений в bothouse. Меняет настройки в ответ на прямые запросы пользователя. CX Codex +1 ★ 262звёзд репо

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

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