Первая задача
Info
Пошаговый сценарий для тех, кто еще не работал с AI-агентом. Занимает около получаса и дает репозиторию файл инструкций, который потом работает во всех сценариях.
Возьмите репозиторий, который знаете, и небольшую понятную задачу: добавить проверку входных данных, покрыть тестом существующую функцию, поправить сообщение об ошибке. Крупную задачу для первого раза брать не стоит — сложнее понять, где именно что-то пошло не так.
Шаг 1. Откройте сессию
- На любой странице GitVerse нажмите кнопку GigaCode в правом нижнем углу.
- Переключитесь в режим Сессии и нажмите Новая сессия.
- Добавьте репозиторий и выберите ветку.
Подробности — на странице Сессии.
Шаг 2. Подготовьте репозиторий командой /init
Отправьте /init первым сообщением.
Агент прочитает README, файлы сборки, конфигурацию CI/CD и настройки тестов, при необходимости задаст пару вопросов и соберет файл AGENTS.md — инструкцию для всех будущих запусков.
Прочитайте результат и удалите все, что не специфично для вашего проекта: общие советы и очевидные соглашения языка попадают в контекст при каждом запросе и только мешают. Оставшееся закоммитьте.
Зачем это первым шагом: без файла инструкций агент каждый раз заново угадывает, чем собирается проект и как запускаются тесты, — и регулярно угадывает неверно. Подробнее — Подготовка репозитория.
Шаг 3. Поставьте задачу в режиме Plan
Выберите агента Plan и опишите задачу целиком: что нужно получить, каких ограничений держаться, что уже решено и обсуждению не подлежит. Не сокращайте до одной строки — на этом шаге полезен объем, а не краткость.
Добавьте к описанию просьбу:
Прежде чем что-то делать, задай мне вопросы по всему, что осталось неоднозначным.
Не спрашивай очевидное — спрашивай о том, что я мог не учесть.Зачем режим Plan: в нем агент физически не может изменить файлы, поэтому обсуждение задачи не превращается в незаметно начавшуюся реализацию.
Шаг 4. Ответьте на вопросы и проверьте план
Агент задаст уточняющие вопросы карточкой — ответьте на них. Затем он предложит план.
Прочитайте план и убедитесь, что в нем есть две вещи:
- границы — что агент не трогает;
- проверка — какой командой или сценарием подтверждается результат.
Если чего-то из этого нет, попросите дописать. Это дешевле, чем разбираться в лишних изменениях потом.
Шаг 5. Выполните и проверьте
Подтвердите план и продолжите с агентом Build. Агент начнет вносить изменения и запрашивать разрешение на действия — карточки подтверждений появятся в ленте.
Когда агент сообщит, что закончил, попросите доказательство:
Запусти проверку и приведи вывод команды. Не описывай результат словами.Зачем это: агент склонен считать задачу выполненной раньше, чем она действительно выполнена, и словесный отчет об успехе ничего не подтверждает.
Что делать, если пошло не так
| Симптом | Причина | Что сделать |
|---|---|---|
| Агент использует не те команды сборки или тестов | этого нет в AGENTS.md | дописать точные команды в файл инструкций |
| Сделано больше, чем просили | в плане не были названы границы | вернуться к шагу 4 и явно перечислить, что не трогаем |
| Ответы стали общими, агент забыл ограничение из начала диалога | контекст переполнен | начать новую сессию под следующую задачу, см. Контекст |
| Агент уверенно ссылается на несуществующий код | он додумал недостающее | потребовать подтверждать утверждения ссылками на файлы и строки |
Что дальше
- Разберите рабочий цикл целиком — Цикл работы с агентом.
- Доведите до ума файл инструкций — Подготовка репозитория.
- Когда появятся повторяющиеся процедуры, вынесите их в навыки.