Задачи

Задачи позволяют разбить цель на направленный граф подзадач, которые AIKraft Agents выполняет в дочерних сессиях. Каждая подзадача может зависеть от предыдущих, иметь собственные критерии приемки, а при ошибках система автоматически пытается исправить результат. Используйте задачи, когда одной сессии недостаточно — когда требуется планирование, ветвление или проверка.

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

Используйте задачу, когда работа:

• Разделяется на шаги, которые могут выполняться параллельно или должны идти в определённом порядке.
• Требует критериев приемки (pass/fail), которые агент может проверить самостоятельно.
• Должна автоматически повторять или исправлять промежуточные ошибки без вашего постоянного контроля.
• Может возобновиться позже — вы закрываете ноутбук, возвращаетесь, и задача продолжает работу с того места, где остановилась.

Для одноразового диалога всё ещё лучше использовать обычную сессию.

Структура задачи

Задача определяется DAG-файлом task.yaml. Каждая вершина — это подзадача; ребра — зависимости. При запуске задачи AIKraft Agents создаёт дочернюю сессию для каждой подзадачи, соблюдая порядок зависимостей.

theme={null}
name: Ship reporting dashboard
description: Build, test, and deploy the new dashboard.

subtasks:
  - id: scaffold
    prompt: Scaffold the dashboard route and page component.
    acceptance:
      - The route /reports renders without errors.

  - id: charts
    prompt: Implement the three summary charts.
    depends_on: [scaffold]
    acceptance:
      - Each chart renders with mocked data.
      - Storybook covers each chart.

  - id: tests
    prompt: Add Vitest coverage for the charts and route.
    depends_on: [charts]
    acceptance:
      - "`bun test` passes."

  - id: deploy
    prompt: Open a PR and request review.
    depends_on: [tests]
    acceptance:
      - PR is open against main with a passing CI run.

Подзадачи без depends_on выполняются первыми, параллельно. Последующие подзадачи разблокируются по мере завершения их зависимостей.

Критерии приемки и цикл исправления

После завершения дочерней сессии подзадачи AIKraft Agents проверяет критерии приемки. Если какой-либо критерий не выполняется, запускается цикл исправления: система передаёт информацию об ошибке обратно в дочернюю сессию с инструкциями по исправлению и повторно проверяет. Этот процесс продолжается, пока критерии не будут удовлетворены, или пока цикл не достигнет максимального количества попыток.

Формулируйте критерии приемки как краткие проверяемые утверждения. Предпочитайте конкретные сигналы — команда тестов завершается без ошибок, файл существует, URL возвращает статус 200 — субъективным описаниям.

Объединение подзадач

При выполнении задачи родительская сессия наследует объединение подзадач: объединённый набор лейблов, привязку к проекту и статус-сигналы всех дочерних сессий. Это означает, что карточка задачи на доске Kanban отражает совокупное состояние — например, прогресс подзадач вида 3 / 5 показывает, сколько подзадач удовлетворили свои критерии приемки.

Возобновление после перерыва

Состояние задачи сохраняется после каждого перехода подзадачи. Если вы закроете приложение, потеряете питание или ваш компьютер перейдёт в спящий режим во время выполнения, повторное открытие задачи продолжит работу с последней завершённой подзадачи. Подзадачи, находившиеся в процессе выполнения, либо продолжат работу, либо начнутся заново — вы никогда не потеряете прогресс DAG.

Редактор задач

Откройте задачу, чтобы увидеть редактор задач. Он имеет два режима:

Вкладка Результаты собирает выходные данные всех подзадач в одном месте — удобно для обзора того, что произвёл агент, без открытия каждой дочерней сессии по отдельности. Элемент управления Привязка сессии связывает задачу с конкретной родительской сессией, чтобы результаты и артефакты оставались связанными.

Площадка задач Playground доступна только в ручном режиме. Ручные запуски позволяют выполнять подзадачи по одной, чтобы изучить поведение, прежде чем запустить задачу полностью.

Создание и запуск задач

Просто спросите своего агента. Скажите: «создай задачу, которая набрасывает, тестирует и разворачивает дашборд отчётов», и агент составит для вас файл task.yaml. Просмотрите его в редакторе задач перед запуском.

Вы также можете:

• Создать задачу с помощью кнопки Новая задача на доске Kanban — задача унаследует активный фильтр проекта.
• Создать подзадачу в существующей задаче и запустить её прямо с карточки.
• Использовать Запуск с плитки на доске, чтобы начать любую задачу без её предварительного открытия.

Рекомендации

Делайте критерии приемки проверяемыми программно

«Тесты проходят» лучше, чем «код выглядит чисто». Цикл исправления работает только тогда, когда есть чёткий сигнал для реакции.

Начинайте мало, затем расширяйте

Сначала создайте задачу из двух или трёх подзадач, запустите её, и расщепляйте дальше, только если подзадача часто завершается с ошибкой или становится слишком объёмной.

Привязывайте задачи к проекту

Задачи, привязанные к проекту, наследуют его рабочую папку и контекст, поэтому подзадачам не нужно заново устанавливать, где находится код на каждом шаге.