almdev Разработка с ИИ

С чего начать · вводный маршрут

Начните разработку с ИИ

Одна небольшая задача — от первого запроса агенту до изменения, которое вы проверили сами.

Для тех, кто уже немного пишет код, но ещё не работал с ИИ-агентом.

Пройти первый шаг
Ваш путь
  1. Понять
  2. Попробовать
  3. Проверить

Шесть шагов. Один законченный цикл.

На выходе

Вы сможете поставить небольшую задачу, понять изменения агента и решить, можно ли их принять.

Что понадобится

Знакомый проект, Git и агент с доступом к коду. Начните с локальной копии без секретов и рабочих данных.

Поймите роль агента

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

Вы выбираете задачу и решаете, что считать результатом. Агент помогает с выполнением. Его уверенное объяснение само по себе не подтверждает, что код работает: проверку нужно увидеть и повторить.

Попробуйте сами

Выберите одно место в знакомом проекте, которое хочется улучшить. Например, в списке задач трудно найти незавершённые. Пока достаточно назвать проблему без предложения архитектуры.

Можно идти дальше, если

Вы можете объяснить, что должно стать удобнее для пользователя, и знаете, где это проверить.

Подготовьте безопасное место для работы

Для первого раза достаточно одного агента. Если привычнее работать в редакторе — используйте встроенный инструмент; если в терминале — CLI. Сравнение всех моделей можно оставить до появления конкретной потребности.

Откройте локальную копию проекта, убедитесь, что она запускается, и сохраните исходное состояние в Git. Отделите незавершённые изменения от новой задачи. Проверьте, к какой папке и командам агент получает доступ; не передавайте ему секреты, ключи и данные пользователей.

Попробуйте сами

Создайте рабочую ветку. Запустите проект и его текущие проверки. Попросите агента найти код нужного списка и назвать команды проверки, пока ничего не меняя. Сверьте ответ с файлами.

Можно идти дальше, если

Вы знаете исходное состояние, можете запустить проект и понимаете, как вернуться к сохранённой версии без потери другой работы.

Поручите одно небольшое изменение

Удобная первая задача имеет видимый результат и небольшие границы. Фильтр существующего списка подходит лучше, чем просьба переделать всё приложение.

Дайте агенту контекст: где находится экран, что сейчас происходит и что должно измениться. Укажите, чего трогать не нужно. Сначала прочитайте предложенный план. Перед разрешением команды убедитесь, что понимаете её действие; непонятную команду попросите объяснить.

Учебный пример

Представим список с открытыми и завершёнными задачами. Добавим переключатель «Только незавершённые». При включении завершённые строки скрываются, при выключении возвращаются. Это учебная ситуация, а не отчёт о реальном эксперименте.

Пример запроса агенту

В существующем списке задач добавь переключатель «Только незавершённые». По умолчанию видны все задачи. При включении остаются только незавершённые. Если таких нет, покажи понятное пустое состояние. Выключение возвращает полный список. Не меняй хранение данных и другие экраны. Сначала найди нужные файлы, предложи короткий план и способ проверки. Дождись моего согласования перед изменениями.

Попробуйте сами

Замените описание списка на свой экран и отправьте запрос. Проверьте план, уточните границы и разрешите небольшое изменение. Если план неожиданно затрагивает полпроекта, верните задачу к одному экрану.

Можно идти дальше, если

Агент сделал изменение в согласованных границах, а вы знаете, какие файлы затронуты.

Проверьте поведение, а не только отчёт

Начните с diff — сравнения кода до и после. Можете ли вы объяснить каждое существенное изменение? Затем запустите проверки проекта и откройте изменённый экран самостоятельно.

Зелёные тесты полезны, когда проверяют нужное поведение. Посмотрите, что именно утверждают новые тесты. Удалённая проверка или замена ожидаемого результата под ошибочный код не делает задачу решённой.

  • До включения фильтра видны и открытые, и завершённые задачи.
  • После включения остаются только незавершённые; повторное выключение возвращает все строки.
  • Если все задачи завершены, показано понятное пустое состояние. Сами записи не удалены.
  • Переключатель доступен с клавиатуры и понятен на узком экране.

Попробуйте сами

Пройдите сценарии вручную, проверьте diff и запустите согласованные тесты. Попросите агента отдельно перечислить то, что он не смог проверить. Сохраните принятое изменение отдельным коммитом только после проверки.

Можно идти дальше, если

Вы сами увидели нужное поведение, понимаете изменения и можете назвать ограничения проверки.

Верните ошибку в конкретный сценарий

Если результат неверный, сообщение «не работает» редко помогает. Опишите исходные данные, свои действия, ожидаемое и фактическое поведение. Приложите текст ошибки или снимок экрана без личных данных.

Если агент повторяет неудачную попытку, остановите правки. Попросите сначала найти причину и предложить способ её проверить. При потере контекста начните новую сессию с коротким описанием задачи, состояния и неудачных попыток. Перед откатом посмотрите diff и сохраните нужную работу; не поручайте очистить всё подряд.

Пример запроса агенту

В списке две завершённые задачи. Включаю «Только незавершённые» — строки исчезают, но пояснения нет. Ожидаю сообщение, что незавершённых задач нет. Сначала найди причину и предложи проверку этого сценария. Затем исправь только его, сохранив поведение выключенного фильтра.

Попробуйте сами

Если нашли дефект — составьте такое сообщение для своего случая. Если всё работает, объясните, как вы бы воспроизвели пустую выдачу и отличили её от ошибки загрузки.

Можно идти дальше, если

У проблемы есть воспроизводимые условия, а исправление проверено тем же сценарием.

Усложняйте работу постепенно

После первого принятого изменения попробуйте похожую задачу: валидацию одного поля, небольшой баг с воспроизведением или тест на знакомое поведение. Так легче замечать, где агент помогает, а где требует больше внимания.

Повторяющиеся команды и ограничения запишите в инструкции проекта. Когда один приём понадобится регулярно, можно оформить скилл. Субагенты пригодятся для действительно независимых частей работы. Для первой законченной задачи всё это не обязательно.

Попробуйте сами

Запишите, какой контекст оказался полезным, где пришлось вмешаться и чем вы проверили результат. Выберите следующую задачу сопоставимого размера.

Можно идти дальше, если

У вас есть принятое изменение и собственное наблюдение, которое поможет в следующей работе.

Небольшой словарь

Термины, которые встретятся в работе. К ним можно вернуться в любой момент.

Агент
ИИ-инструмент, который выполняет последовательность действий с доступными ему файлами и командами.
Контекст
Данные, на которые опирается агент: запрос, история разговора, инструкции и прочитанный код.
Diff
Сравнение версий файла: какие строки добавлены, изменены или удалены.
Инструкции проекта
Записанные правила работы с репозиторием: устройство кода, команды проверки и ограничения.
Скилл
Повторно используемая инструкция для определённого вида задач; конкретный формат зависит от инструмента.
Субагент
Отдельный агент, которому основной поручает часть работы. Его результат тоже требует проверки.

Продолжите в своём темпе

Дополнительные материалы вводной серии. Выберите вопрос, который возник у вас в работе; читать всё подряд не обязательно.

Первая задача — только начало

Вернитесь к этому маршруту с новой задачей. Со временем у вас появятся свои короткие постановки, способы проверки и границы доверия агенту.

К началу маршрута