agent_supervise — субагент для Claude Code: задачи и установка
Субагент agent_supervise для Claude Code берёт под контроль уже запущенного агента и связывает его работу с задачей текущего разговора. Он получает сообщения о ходе работы, а завершённую задачу закрывает через task_review.
MIT ★ 395 обновлён 2026-11-16
.claude/agents/agent_supervise.mdЧто делает agent_supervise
Субагент добавляет задачу разговора для агента, которого запустили вручную на странице Agents или через agent_start без задачи. В задаче можно задать проверяемый результат и ожидаемое время; долгий простой считается зависанием. Сообщения приходят, когда агент ждёт проверки или ответа, останавливается либо сообщает о результате.
По умолчанию сообщения получает фоновый супервизор, который также проверяет задачу; её можно проверить и самостоятельно. С настройкой assistant.main_supervises_own_tasks сообщения направляются основному разговору. Для агента уже существующей задачи меняются её критерий завершения и ожидаемое время, а правка записывается как изменение объёма работы. Для такого изменения предназначен task_scope. Агент из задачи другого разговора остаётся там.
Какие задачи решает
- взять под контроль вручную запущенного агента
- привязать агента без задачи к текущему разговору
- отслеживать ожидание проверки, ответа или прогресс
- изменить критерий завершения и срок текущей задачи
Примеры запросов агенту
- Возьми под контроль агента
SESSION_IDна машинеMACHINEи добавь его работу как задачу этого разговора. - Поставь агенту
SESSION_IDзадачу с проверяемым результатом и ожидаемым временем в минутах. - Измени критерий завершения и ожидаемое время задачи, которую выполняет агент
SESSION_ID.
Как установить agent_supervise
Вручную: положить файлы
.claude/agents/agent_supervise.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/agent_supervise.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/agent_supervise.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об agent_supervise
Как установить agent_supervise в Claude Code?
Добавь файл субагента по пути .claude/agents/agent_supervise.md.
Что делает agent_supervise?
Он превращает вручную запущенного агента без задачи в задачу текущего разговора и отслеживает её сообщения о ходе работы. Завершённую задачу закрывает task_review.
Куда приходят сообщения супервизора?
По умолчанию их получает фоновый супервизор, который проверяет задачу. При включённой настройке assistant.main_supervises_own_tasks сообщения получает основной разговор.
Исходный текст
agent_supervise.md · MIT
Take an agent you did not hand out (opened by hand on the Agents page, or by agent_start without a task) under your supervision, from the main conversation, as if task_plan had started it: it becomes a task of this conversation (a todo, its card in the conversation) that is followed up: a 督办 message comes when it needs its supervisor (waits for review, stopped short, waits for an answer, makes no progress, reports), and task_review closes it. By default the background supervisor, the built-in conversation that follows up the tasks no leader supervises, gets those messages and reviews the task, and you may still review it yourself; with assistant.main_supervises_own_tasks on they come to you. The answer says which. On an agent of a task you supervise already, it sets that task's done_when and expect_minutes instead, as a logged scope change of the task's brief (the same rules as task_scope, which is the tool to use for it). An agent of another conversation's task stays that conversation's.
```json
{
"type": "object",
"required": ["machine", "session_id"],
"properties": {
"machine": {
"type": "string",
"description": "the machine's id or name, as agents_list shows it"
},
"session_id": {
"type": "string",
"description": "the agent's session id, or its first 8 characters"
},
"title": {
"type": "string",
"description": "the task in a short line (Chinese, under 20 characters); empty: the agent's title"
},
"done_when": {
"type": "array",
"maxItems": 6,
"items": { "type": "string" },
"description": "results you can check when it says it is done (a PR merged, a screenshot, what the live system answers)"
},
"expect_minutes": {
"type": "integer",
"description": "how long it should take from now; longer without progress counts as stuck"
}
}
}
```
© nwverse · MIT · nwverse/persona