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) → выполнение и независимое ревью шага → независимое финальное ревью → правдивый итог. Дефект артефакта возвращается на исправление; неверный критерий или вышестоящая причина — в планирование.
Долговечный workspace
Заголовок раздела «Долговечный workspace»Первая директива создаёт или возобновляет ./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. Для каждого шага плана:
- Исполнитель читает текущий план, зафиксированные требования и релевантные предыдущие доказательства или решения.
- Он выполняет только текущий шаг и записывает новый
evidence.md, привязанный к версии плана; прежние попытки сохраняются. - Независимый коллега читает первичный результат, evidence, требования и план, затем записывает
verdict.mdрядом с evidence-файлом. Он возвращаетpass,repairилиreplan; для repair также указывает владельца:resultилиevidence_projection. - Repair результата воспроизводит дефект до изменения и расходует retry-бюджет только после содержательно изменённой попытки. Repair evidence или projection сохраняет уже правильный результат и сразу возвращается к тому же reviewer, не расходуя продуктовый retry.
- Если repair обнаруживает дефект плана, критерия, владельца или метода доказательства, он возвращает
reassessи перепланирует работу от этой точной текущей причины. Повтор того же корня требует нового знания или replanning, а не следующего слоя того же механизма. - Вердикт
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;
- критичная работа, где нерешённые обязательства нельзя молча считать завершёнными.
Связанное
Заголовок раздела «Связанное»- Quick Task — небольшие ограниченные задачи
- Обзор шаблонов — все встроенные workflow