Flownix
Разделы
На этой странице

Выполнить задачу

Статусы, комментарии как память агента, коммит и правило «оставить в testing, а не в done».

Выполнение — это не только код. Это код плюс след, по которому следующий агент не начнёт с нуля. Вторая половина здесь не менее важна: агент между сессиями не помнит ничего, и всё, что не записано в ноду, потеряно.

Как запустить

в сессии агента
/execute-task AF-TASK-42

Называть скилл не обязательно. Он подхватывается по смыслу просьбы, поэтому в жизни чаще пишут короче — и это работает так же:

в сессии агента
возьми AF-TASK-42
в сессии агента
доделай AF-PLAN-7, там три задачи остались

Что происходит

Контекст поднимается до работы

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

Задача берётся в работу

Статус меняется на «в работе» — на доске сразу видно, чем занят агент, и вы не обнаруживаете это постфактум.

Работа идёт шагами со следом

На каждом осмысленном шаге агент оставляет комментарий:

ПометкаЧто означает
[progress]что сделано и с каким результатом
[decision]неочевидный выбор и почему именно так
[blocker]что мешает и что нужно, чтобы сдвинуться
[done]итог: что реализовано, где, как проверить

Ценность здесь в [decision]. Код показывает, что сделано; почему выбрали это, а не соседний вариант, не показывает ничто, кроме такой записи.

Закрытие

Задача переводится в «тестирование», в неё записывается хэш коммита, и остаётся комментарий [done] с тем, как проверить результат.

Статусы честно

Прогресс родителя считается по статусам задач внутри, поэтому неверный статус портит картину всего дерева.

  • в работе — прямо сейчас, а не «начал месяц назад».
  • заблокировано — с комментарием [blocker], называющим, что именно мешает. Заблокированная задача без причины неотличима от заброшенной.
  • тестирование — сделано, проверяется.
  • регрессия — проверка нашла проблемы.

Что делаете вы

Проверяете по критериям приёмки, а не по объёму сделанного. Критерии написаны в задаче — если их нет, это первый вопрос, а не последний.

Читаете [decision]. Если решение выглядит неверным, спорить о нём дешевле сейчас, чем через месяц по коду.

Переводите в «выполнено» — или в «регрессию» с тем, что не так.

Дальше