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

Robust Task

Robust Task выполняет сложную многошаговую работу через долговечный workspace в файловой системе. Исполнитель отвечает за полный согласованный результат, а независимые ревьюеры классифицируют блокирующие замечания по их ранней причине и направляют их в repair или replanning. Неизменяемые планы, попытки, решения и ревью позволяют восстановить выполнение после потери контекста, а ограниченный repair не даёт выдать незакрытую работу за завершённую.

Workflow требует агента с доступом к файловой системе. Для небольших ограниченных задач используй Quick Task. Для реализации или рефакторинга репозитория используй Software Development Flow, который ведёт полный цикл разработки.

Окно терминала
mcp__moira__execution({ action: "prepare", workflowId: "moira/robust-task", parentExecutionId: "none" })
mcp__moira__execution({ action: "execute", startAttemptId: "<ID попытки запуска из prepare>" })

План → независимое ревью плана → согласование (interactive) → выполнение и независимое ревью шага → независимое финальное ревью → правдивый итог. Дефект артефакта возвращается на исправление; неверный критерий или вышестоящая причина — в планирование.

Первая директива создаёт или возобновляет ./moira-ws/<task-name>-<YYYYMMDD>-<HHMM>/. process-id.txt связывает его с выполнением для восстановления через execution({ action: "current_step", executionId }). На диске остаются зафиксированные требования и руководство, неизменяемые версии плана с ревью и решениями, привязанные к плану попытки с доказательствами и вердиктами, переоценки исправлений, финальные ревью и выдача результата.

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

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

Независимый коллега проверяет полный текущий план против зафиксированных требований, первичных источников и реального контекста проекта. Для каждого блокера он определяет раннюю причину: артефакт workflow, validation или test, недостаточное evidence, документация или projection, ошибочный или недоказуемый критерий либо вышестоящий план или процесс. Результат — pass, repair или replan. Локальный repair разрешён, только если сам план владеет всеми блокерами; иные или смешанные причины возвращаются в планирование.

Тело плана остаётся в plan.md; каждая нода, которая пишет план, возвращает и plan_steps — короткое название каждого шага в порядке плана, не больше 30, — из которых workflow выводит total_steps. Эти названия — список плана, который люди видят в уведомлениях и на странице прогона.

Repair не перезаписывает проверенный план. Сначала он воспроизводит проблему, затем возвращает changed с новым plans/NNN/plan.md либо reassess с plans/NNN/repair.md, если замечание нельзя честно исправить локально. У прямого review и reassessment владельца repair разные потребители replan, поэтому исторический reassessment не становится причиной более позднего перехода только из-за того, что его файл всё ещё существует.

Автоматический цикл ревью плана ограничен max_review_rounds (по умолчанию 5). На лимите пользователь или автономный агент явно выбирает ещё один обоснованный repair либо правдивую incomplete-выдачу; исчерпание счётчика не продвигает заблокированный план. В интерактивном режиме выполнение начинается только после безусловного согласия с точным планом. Отклонение создаёт новую версию и возвращает её на ревью.

На первом шаге определяется operating_mode: autonomous или interactive. Агент использует режим, который пользователь уже назвал, выводит однозначный сам — в том числе когда запуск дочерний для уже автономного процесса, — и спрашивает один раз только тогда, когда режим не назван и не выводится. До завершения этого шага он сохраняет фактическое название задачи через защищённые метаданные Progress/execution; следующая нода доставляет workflow-guide.md остальным потребителям. Необязательная execution_note — произвольный непустой текст до 120 символов, отдельный от заголовков. Он же возвращает goal_summary — результат, которого должна достичь задача, одним предложением; его показывают сообщения о плане. Ответственный за пересмотр или реплан обновляет название только при разрешённом изменении самой задачи; обычное исправление и перестановка сохраняют его, завершённые позиции и доказательства.

В режиме interactive всё описанное выше не меняется. В режиме autonomous гейт согласования плана обходится, а каждое ограниченное решение агент принимает по доказательствам: ещё один проход исправлений — только для воспроизводимых и исправимых сейчас находок, retry — только когда что-то существенно изменилось, replan — когда сбой обесценивает план, а не попытку, иначе фиксируется incomplete. Независимые ревью, лимиты retry и ревью, маршруты реплана и долговечные записи одинаковы в обоих режимах, а принятые пробелы остаются видимыми в delivery: автономность убирает ожидание, а не честность.

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

Движок владеет однобазовым курсором current_step. Для каждого шага плана:

  1. Исполнитель читает текущий план, зафиксированные требования и релевантные предыдущие доказательства или решения.
  2. Он выполняет только текущий шаг и записывает новый evidence.md, привязанный к версии плана; прежние попытки сохраняются.
  3. Независимый коллега читает первичный результат, evidence, требования и план, затем записывает verdict.md рядом с evidence-файлом. Он возвращает pass, repair или replan; для repair также указывает владельца: result или evidence_projection.
  4. Repair результата воспроизводит дефект до изменения и расходует retry-бюджет только после содержательно изменённой попытки. Repair evidence или projection сохраняет уже правильный результат и сразу возвращается к тому же reviewer, не расходуя продуктовый retry.
  5. Если repair обнаруживает дефект плана, критерия, владельца или метода доказательства, он возвращает reassess и перепланирует работу от этой точной текущей причины. Повтор того же корня требует нового знания или replanning, а не следующего слоя того же механизма.
  6. Вердикт pass продвигает курсор.

step_retry управляет бюджетом содержательных исправлений результата, не является номером долговечной директории попытки и не увеличивается для исправлений evidence или projection. Когда израсходовано max_retries изменённых result-repair (по умолчанию 3), пользователь или автономный агент выбирает один из трёх исходов:

РешениеЭффект
retryПовтор только с изменёнными входными данными, новой гипотезой, изменившимся внешним состоянием либо новой конкретной работой или доказательством
replanСохранить завершённые шаги и перестроить открытый шаг и невыполненный хвост
finish_incompleteОстановить дальнейшее выполнение и автоматические исправления, затем выдать точный нерешённый объём как incomplete

Решение сохраняется в steps/<step>/decisions/NNN.md. Перепланирование может изменить зафиксированные требования только тогда, когда то же решение пользователя явно называет и разрешает конкретное изменение и его причину.

Узел teleport-replan также доступен, если во время выполнения агент обнаружил, что текущий план больше не соответствует реальной работе. Он сохраняет завершённые шаги и отправляет новый полный план на ревью и согласование.

После закрытия всех шагов одно независимое final-review заново выводит активные обязательства из зафиксированных требований, согласованного плана, реального результата, первичных артефактов, принятых записей шагов и разрешённых решений. Оно не полагается на заявление исполнителя о полноте и не дублирует тот же семантический gate. Механические проверки подтверждают только различимые ими свойства; семантическая полнота и архитектура требуют суждения по реальным артефактам.

Reviewer возвращает pass, repair или replan. Для локального repair он назначает владельца deliverable или evidence_projection. Владелец воспроизводит текущее замечание до изменения и возвращает changed тому же reviewer либо reassess, если нужно изменить план, критерий, метод evidence или ownership. Прямой replan финального review и replan reassessment используют отдельные пути текущей причины.

Цикл ограничен max_review_rounds. На лимите пользователь или автономный агент может разрешить ещё один обоснованный repair либо явно принять точный оставшийся объём как incomplete. Исчерпание счётчика никогда не превращает нерешённое замечание в pass.

final/delivery.md выводится из зафиксированных требований, текущего согласованного плана, долговечных записей шагов, ревью, разрешённых изменений требований и решений о принятии неполноты. delivery_status равен complete только когда не осталось нерешённых активных обязательств; иначе он равен incomplete, а нерешённый объём раскрывается.

End node возвращает ровно:

{
"workspace_path": "./moira-ws/.../",
"delivery_file": "final/delivery.md",
"delivery_status": "complete | incomplete",
"summary": "Краткое правдивое итоговое резюме"
}

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

Сообщения приводят причину отказа текущего ревью, принятое решение и его основание либо итог. Отсутствие настроенного канала отклоняет старт, если новая подготовка явно не использует skipNotificationCheck: true; ошибка доставки не останавливает workflow.

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

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