task_scope — субагент для Claude Code: задачи и установка
Субагент task_scope для Claude Code меняет цель контролируемой задачи после её запуска. Он обновляет критерии завершения и срок, а владелец видит изменение в следующем дайджесте.
MIT ★ 395 обновлён 2026-11-16
.claude/agents/task_scope.mdЧто делает task_scope
task_scope меняет содержание уже запущенной задачи по её todo_id: записывает в журнал краткое описание изменения и причину, задаёт новые критерии завершения и ожидаемое время, затем перезапускает отсчёт времени. Исходный запрос владельца и первоначальные критерии остаются в брифе. В списке done_when нужно передать все критерии после изменения: пропущенные будут отмечены как снятые, и это попадёт в отчёт о завершении.
Вызывать субагент может только супервизор задачи. Если изменение добавляет действие, разрешить которое может только владелец, например публикацию или удаление, а такого действия не было в исходной задаче, сначала нужно получить ответ владельца и лишь затем повторить изменение. Субагенту отправляют описание изменения отдельно. Для просроченной задачи, которая остаётся актуальной, можно указать причину и новый срок в минутах.
Какие задачи решает
- изменить цель уже запущенной задачи
- обновить критерии завершения и срок задачи
- зафиксировать снятые критерии в отчёте о выполнении
- продлить актуальную просроченную задачу
Примеры запросов агенту
- Измени задачу
todo_…: вместо проверки в рабочей среде оставь только тестовую, срок пересчитай на 30 минут. - Задача
todo_…всё ещё актуальна. Зафиксируй причину задержки и дай ей ещё 20 минут. - Убери из критериев задачи
todo_…пункт про публикацию и запиши причину изменения.
Как установить task_scope
Вручную: положить файлы
.claude/agents/task_scope.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/task_scope.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/task_scope.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о task_scope
Как установить task_scope в Claude Code?
Добавь файл субагента по пути .claude/agents/task_scope.md.
Что делает task_scope?
Он меняет цель и критерии уже запущенной задачи, записывает изменение с причиной в журнал и обновляет ожидаемое время. Пропущенные из нового списка критерии отмечаются как снятые.
Кто может менять задачу через task_scope?
Только её супервизор. Если изменение добавляет действие, которое может разрешить только владелец, сначала нужно получить его ответ.
Исходный текст
task_scope.md · MIT
Change what a task you supervise is to do, or what done means for it, after it started (its todo id). The task's brief (the owner's request and the criteria it started with) is never rewritten: this adds an entry to the brief's log with what changed and why, applies the new done_when and expect_minutes, restarts the task's clock, and the owner reads the change in their next digest. It is the only way done_when changes after a task started (agent_supervise and agent_send with a task on your own task go through the same log). Give done_when as the whole list after the change: a criterion you leave out is recorded as dropped by this change, and the completion report says so. A change that adds a step only the owner may allow (deploying, merging, releasing, sending or commenting where other people see it, deleting, spending, changing production) and was not part of the task is refused unless the owner's own message started this turn: ask them first (ask_user, or task_review needs_user), then call it again when they answered. Only the task's supervisor may call it. The agent is not told: send it what changed with agent_send. Use it also to answer an overdue task that is still right: say why and give the new expect_minutes.
```json
{
"type": "object",
"required": ["todo_id", "change", "why"],
"properties": {
"todo_id": {
"type": "string",
"description": "the task's todo id (todo_…)"
},
"change": {
"type": "string",
"description": "what changes, in one sentence the owner can read (Chinese), e.g. 「不再要求灰度验证,改为只在测试环境验证」"
},
"why": {
"type": "string",
"description": "why, in one sentence (Chinese)"
},
"done_when": {
"type": "array",
"minItems": 1,
"maxItems": 6,
"items": { "type": "string" },
"description": "the criteria after the change, the whole list; leave it out to keep them as they are"
},
"expect_minutes": {
"type": "integer",
"minimum": 0,
"description": "how long the task should take from now; leave it out (or 0) to keep it"
}
}
}
```
© nwverse · MIT · nwverse/persona