Перейти к содержимому

Todo List

Todo List превращает одну цель в упорядоченный checklist и выдаёт по одной задаче. Это намеренно не журнал результатов: workflow не классифицирует исходы задач, не агрегирует evidence и не строит итоговый отчёт.

mcp__moira__execution({ action: "prepare", workflowId: "moira/todo-list", parentExecutionId: "none" })
mcp__moira__execution({ action: "execute", startAttemptId: "<ID попытки запуска из prepare>" })

Первый шаг получает от 1 до 100 задач. Если в текущем контексте пользователя или вызывающей стороны уже есть корректный по схеме готовый список, его содержание остаётся за автором: каждый пункт передаётся с неизменной формулировкой и объёмом, ничего не выбрасывается и не дописывается незаказанная работа. Очередь принадлежит исполнителю: пункты ставятся туда, где их предпосылки уже выполнены, замечание, управляющее всей работой, привязывается к пунктам, которые оно ограничивает, а не исполняется отдельной задачей, и если получившийся порядок расходится с написанным, расхождение и вызвавшая его зависимость видны автору до начала работы. Иначе тот же шаг один раз составляет список из текущей цели. Каждая задача содержит только:

  • action: самодостаточную работу, которую нужно выполнить;
  • expected_result: наблюдаемое условие завершения.

Обе строки непустые и ограничены 1 000 символами. Позиция в массиве служит идентификатором задачи; агент не передаёт ID, курсор, общее число, статусы или коды результата.

До завершения получения списка агент сохраняет фактическое название задачи по защищённому контракту именования в уже доставленном workflow-guide.md. Необязательная execution_note — произвольный непустой текст до 120 символов, который не задаёт заголовок. Разрешённый пересмотр списка обновляет название только при изменении самой задачи; одна перестановка его сохраняет. Именование не меняет завершённые позиции и не даёт новых полномочий.

Todo List владеет курсором с единицы. Он проецирует текущую задачу, сообщает агенту действие и ожидаемый результат и ждёт. Агент выполняет реальную работу и проверяет результат до вызова execution с action: "step", передавая локальный evidence и ограниченный результат для отображения в input:

{
"evidence": "Целевая команда тестов прошла.",
"progress_execution_outcome": "Затронутый набор тестов прошёл"
}

Обе строки непустые и имеют длину не больше 500 символов. evidence — конкретное подтверждение текущего шага; оно остаётся локальным для ноды и не копируется в глобальный массив или терминальный отчёт. progress_execution_outcome заменяет последнюю подтверждённую сводку Work только для отображения; это не evidence, и само по себе значение не продвигает курсор.

Если задача не завершена или заблокирована, агент не вызывает execution с action: "step". Он сообщает пользователю проверенную причину, поэтому курсор остаётся на текущей задаче. Корректное по JSON Schema подтверждение продвигает курсор ровно один раз. Исчерпание упорядоченного массива завершает workflow.

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

Когда неверным оказывается сам checklist — оставшиеся задачи устарели, чего-то не хватает или порядок неправильный, — агент переходит к ноде пересмотра, вместо того чтобы доводить до конца список, о неверности которого уже знает:

mcp__moira__execution({ action: "step", processId, attemptId, teleportTo: "teleport-revise-tasks" })

Это цель перехода (teleport): в неё не ведёт ни один шаг, поэтому пересмотр всегда осознанное решение. Это не способ уйти от задачи, которая просто сложна, заблокирована или падает, — для такого случая действует правило выше.

Шаг пересмотра запрашивает полный исправленный checklist и позицию, с которой продолжать:

{
"tasks": [
{ "action": "…уже выполненная задача, без изменений…", "expected_result": "…" },
{ "action": "Исправить конфигурацию, ошибку в которой выявила первая задача", "expected_result": "Сервис запускается с исправленной конфигурацией" }
],
"resume_from_task": 2,
"progress_checklist_outcome": "Исправленный список сохраняет завершённый префикс и две оставшиеся задачи",
"progress_execution_outcome": "Первая задача остаётся проверенной"
}

Уже выполненные задачи сохраняют исходные позиции: позиция служит идентификатором задачи, и выполнение возобновляется по позиции. Всё, что находится до resume_from_task, считается сделанным и повторно не выполняется. Workflow сам пересчитывает общее число из переданного массива — агент не передаёт ни счётчики, ни арифметику курсора — и продолжает через обычную проверку курсора, поэтому позиция за концом нового списка просто завершает выполнение.

Вызывающая сторона запускает Todo как дочерний workflow и включает готовый корректный по схеме массив задач в контекст дочерней задачи. Первый шаг Todo передаёт этот массив в input обычного вызова execution с action: "step":

{
"tasks": [
{
"action": "Проверить реализованное требование",
"expected_result": "Предметный отчёт вызывающей стороны содержит проверенный результат"
}
],
"progress_checklist_outcome": "Одна упорядоченная задача готова",
"execution_note": "Проверить реализованное требование"
}

Отдельной ветки supplied tasks и pre-start input mapping нет. Intake-шаг сохраняет содержание готового массива, а не перепланирует его, упорядочивает его по зависимостям и начинает с первого пункта. Если два присланных пункта нуждаются в результате друг друга, ни один порядок не удовлетворяет обоим, и такая пара называется автору, а не выбирается молча. Предметные результаты остаются у вызывающей стороны. Например, workflow проверки требований должен сам записывать отчёт и владеть классификациями COVERED/GAP, а не использовать Todo List для их передачи.

Todo List отправляет два уведомления в настроенные каналы пользователя, у каждого заголовок — название флоу и задача прогона, ссылкой на страницу прогона:

  • «Checklist ready» (checklist готов) — когда checklist подтверждён и работа началась, со всем checklist (▶ у первой задачи, ○ у остальных);
  • «All tasks done» (все задачи выполнены) — перед завершением прогона, со всеми задачами, отмеченными ✓. После пересмотра это исправленный checklist.

Тексты сообщений — на английском.

У флоу нет гейтов пользователя, поэтому ничто не просит читателя действовать. Поскольку флоу отправляет уведомления, его запуск для пользователя без настроенного канала отклоняется с инструкцией; агент, который хочет работать без уведомлений, заново готовит запуск с skipNotificationCheck: true. Дочерние прогоны уведомляют так же, как верхнеуровневые.

Todo List завершается с пустым терминальным результатом: {}. Завершение означает, что каждый пункт checklist получил корректное по схеме подтверждение после выполнения и проверки агентом. Evidence отдельных пунктов остаётся в истории взаимодействия исполнения; накопленный output API для него не обещается.

Если вызывающему subgraph нужны предметные данные, он должен сформировать и сохранить их сам. Ветка Todo success означает только достижение End-ноды checklist.