Разделы
На этой странице
Выполнить задачу
Статусы, комментарии как память агента, коммит и правило «оставить в testing, а не в done».
Выполнение — это не только код. Это код плюс след, по которому следующий агент не начнёт с нуля. Вторая половина здесь не менее важна: агент между сессиями не помнит ничего, и всё, что не записано в ноду, потеряно.
Как запустить
/execute-task AF-TASK-42Называть скилл не обязательно. Он подхватывается по смыслу просьбы, поэтому в жизни чаще пишут короче — и это работает так же:
возьми AF-TASK-42доделай AF-PLAN-7, там три задачи осталисьЧто происходит
Контекст поднимается до работы
Агент читает описание задачи и все комментарии — там лежат решения, принятые раньше. Затем поднимает окружающее знание поиском по смыслу: похожие задачи, принятые решения, соседние модули. Тикет не повторяет то, что уже записано в проекте, — агент это находит.
Задача берётся в работу
Статус меняется на «в работе» — на доске сразу видно, чем занят агент, и вы не обнаруживаете это постфактум.
Работа идёт шагами со следом
На каждом осмысленном шаге агент оставляет комментарий:
| Пометка | Что означает |
|---|---|
[progress] | что сделано и с каким результатом |
[decision] | неочевидный выбор и почему именно так |
[blocker] | что мешает и что нужно, чтобы сдвинуться |
[done] | итог: что реализовано, где, как проверить |
Ценность здесь в [decision]. Код показывает, что сделано; почему выбрали
это, а не соседний вариант, не показывает ничто, кроме такой записи.
Закрытие
Задача переводится в «тестирование», в неё записывается хэш коммита, и остаётся
комментарий [done] с тем, как проверить результат.
Статусы честно
Прогресс родителя считается по статусам задач внутри, поэтому неверный статус портит картину всего дерева.
- в работе — прямо сейчас, а не «начал месяц назад».
- заблокировано — с комментарием
[blocker], называющим, что именно мешает. Заблокированная задача без причины неотличима от заброшенной. - тестирование — сделано, проверяется.
- регрессия — проверка нашла проблемы.
Что делаете вы
Проверяете по критериям приёмки, а не по объёму сделанного. Критерии написаны в задаче — если их нет, это первый вопрос, а не последний.
Читаете [decision]. Если решение выглядит неверным, спорить о нём дешевле
сейчас, чем через месяц по коду.
Переводите в «выполнено» — или в «регрессию» с тем, что не так.
Дальше
- Строгий режим — когда закрытие требует обновления спеки
- Ревью кода