План, список дел и цель
Большая задача в Buff Code: план с утверждением, список дел агента и цель /goal — агент делает ходы, пока проверка не подтвердит результат.
Три способа держать большую задачу под контролем:
| Что это | Когда нужно | |
|---|---|---|
| План | агент сначала изучает код и предлагает план, ничего не меняя; работать начинает после вашего «да» | задача затрагивает несколько файлов или решений, и вы хотите согласовать подход |
| Список дел | агент разбивает работу на шаги и отмечает сделанное | любая многошаговая задача — агент ведёт его сам |
| Цель | агент делает ход за ходом, пока проверка не подтвердит результат | результат проверяемый, а число шагов заранее неизвестно |
План
Нажмите «План» в строке под полем ввода и опишите задачу. Пока отметка включена, агент читает и ищет, задаёт вопросы, но не правит файлы и не запускает команды, которые что-то меняют.
- Агент изучает код. Если в задаче не хватает решения, он спрашивает — вопросом с вариантами ответа (см. Вопросы агента).
- План приходит карточкой «План · Ждёт утверждения»: правила, шаги, файлы, проверка. «Показать целиком» раскрывает длинный план, «Копировать» — копирует его текстом.
- Над полем ввода — вопрос «Утвердить план и начать работу? Или напишите, что поправить»:
- «Утвердить и начать» — режим плана выключается, агент приступает к работе;
- свой ответ — что поправить; агент перепишет план и спросит снова.
После утверждения карточка помечается «Утверждён». Начинать новые сессии сразу в «Плане» можно выбрать при первом запуске или в настройках — см. Настройки.
Список дел
Для многошаговой работы агент ведёт список дел: строка «Дела 0/4 · Добавить дорогой чай в catalog.js» показывает, сколько сделано и что идёт сейчас. Та же строка — над полем ввода; щелчок раскрывает весь список, сделанное зачёркнуто.
Цель
/goal <что должно быть правдой> ставит сессии цель. Агент делает ход, после каждого хода
отдельная проверка решает, достигнута ли цель, — и если нет, агент получает причину и делает
следующий ход.
/goal в файле stock.txt записано число 2. За один ход увеличивай число на 1 (нет файла — создай с 1) и заканчивай ходНад полем ввода — строка цели:
- «Цель · итерация 2 · Идёт: …» — под ней вывод проверки после прошлого хода: что уже сделано и чего не хватает;
- «Пауза» — остановиться после текущего хода, «Продолжить» — вернуться к цели;
- «Сбросить» — убрать цель.
Когда проверка подтверждает результат, строка становится зелёной — «Достигнута» — с объяснением, почему. В ленте под последним ответом — свёрнутая отметка «Цель» с тем же итогом.
Что стоит знать:
- Если ответ проверки нельзя разобрать, она переспрашивает один раз, а затем ставит цель на паузу с её ответом — вместо бесконечного круга.
- Ход, оборвавшийся с ошибкой, ставит цель на паузу с текстом ошибки.
- Пишите цель как проверяемое утверждение о результате («тесты зелёные», «в файле записано 2»), а не как действие.
В консоли
| Что | Как |
|---|---|
| план | shift+tab — смена агента на Plan и обратно; план приходит в ленту, утверждение — вопросом |
| список дел | строка «Дела N/M · /todos» под лентой; /todos — список целиком |
| цель | /goal <текст>; строка цели над полем ввода; пауза, продолжение и сброс — в палитре (ctrl+p): «Buff: goal — pause / resume / reset» |
Изменения и откат
Что агент изменил за ход и как это вернуть: сводка под ответом, дифф, безопасный откат с проверкой чужих правок, дерево и просмотр файлов.
Побочный диалог
Побочный диалог: спросить по ходу работы, не сбивая основную задачу. Он видит основную сессию, она его — нет; выделенное уходит цитатой.