# TaskCreate

Создаёт новую задачу в списке задач текущей команды (или в списке задач сессии, когда команда не активна). Используйте, чтобы фиксировать рабочие пункты, которые нужно отслеживать, делегировать или вернуться к ним позже.

## Когда использовать

- Пользователь описывает многошаговую работу, которая выигрывает от явного отслеживания.
- Вы разбиваете большой запрос на меньшие, отдельно завершаемые единицы.
- По ходу задачи обнаружен follow-up, который не должен быть забыт.
- Нужна долговременная запись намерения перед передачей работы сокоманднику или подагенту.
- Вы работаете в режиме планирования и хотите, чтобы каждый шаг плана был представлен конкретной задачей.

Пропускайте `TaskCreate` для тривиальных одноразовых действий, чистой беседы или всего, что выполнимо за два-три прямых вызова инструментов.

## Параметры

- `subject` (string, обязательный): короткий императивный заголовок, например `Fix login redirect on Safari`. Держите примерно до восьмидесяти символов.
- `description` (string, обязательный): подробный контекст — проблема, ограничения, критерии приёмки и любые файлы или ссылки, которые понадобятся будущему читателю. Пишите так, будто сокомандник возьмёт это с чистого листа.
- `activeForm` (string, необязательный): текст-спиннер в настоящем продолженном времени, показываемый, пока задача `in_progress`, например `Fixing login redirect on Safari`. Отражайте `subject`, но в форме на -ing.
- `metadata` (object, необязательный): произвольные структурированные данные, прикреплённые к задаче. Частые применения: метки, подсказки о приоритете, внешние идентификаторы тикетов или конфигурация, специфичная для агента.

Вновь созданные задачи всегда стартуют со статусом `pending` и без владельца. Зависимости (`blocks`, `blockedBy`) не устанавливаются во время создания — применяйте их позже через `TaskUpdate`.

## Примеры

### Пример 1

Зафиксировать баг-репорт, который только что подал пользователь.

```
TaskCreate(
  subject: "Repair broken PDF export on Windows",
  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
  activeForm: "Repairing broken PDF export on Windows"
)
```

### Пример 2

Разбить эпик на отслеживаемые единицы в начале сессии.

```
TaskCreate(
  subject: "Draft migration plan for auth service",
  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
  activeForm: "Drafting migration plan for auth service",
  metadata: { "priority": "P1", "linearId": "AUTH-214" }
)
```

## Примечания

- Пишите `subject` в повелительном наклонении, а `activeForm` — в настоящем продолженном, чтобы UI читался естественно, когда задача переходит в `in_progress`.
- Вызывайте `TaskList` перед созданием, чтобы избежать дубликатов — список команды общий с сокомандниками и подагентами.
- Не включайте секреты или учётные данные в `description` или `metadata`; записи задач видны всем с доступом к команде.
- После создания перемещайте задачу по её жизненному циклу через `TaskUpdate`. Не оставляйте работу молча брошенной в `in_progress`.
