Личное использование on AI Coding Playbook

Типы ИИ-инструментов

Wed, 01 Jan 2025 00:00:00 +0000

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

QA в чате

Примеры инструментов - ChatGPT, Deepseek, Qwen Chat, Claude.ai.

Режим работы - задал вопрос, получил ответ.

Плюсы:

Недорого или вообще бесплатно
Удобно для точечных вопросов - открыл вкладку, закинул вопрос с контекстом, получил ответ
Заставляет думать при создании контекста/промпта - нужно вручную собирать нужный контекст, поэтому итоговый запрос получается более точечным и вдумчивым. Хотя на текущем этапе развития веб-чаты уже тоже могут собирать контекст из подключенных источников

Минусы:

Начало работы с Claude Code

Wed, 01 Jan 2025 00:00:00 +0000

За прошлый год мы потестили достаточно большое количество ИИ-инструментов для разработки (Cursor, Claude Code, Codex, Cline, Aider, RooCode, Kilo, Augment), тут есть обзорный пост. Какие-то отбросили почти сразу, какие-то прям поиспользовали и даже посравнивали на одних и тех же задачах. В итоге сейчас на уровне компании мы внедряем Claude Code и опционально компенсируем подписку на Cursor. Почему Claude Code?

Главная причина - на субъективных ненаучных сравнениях качество лучше, чем у конкурентов (хотя это может меняться от модели к модели)
Богатая эко-система плагинов и в целом это популярный развивающийся инструмент
Адекватная цена - за 35 (Team-план) или 100 (личный Max) долларов мы получаем практически безлимитные запросы (хотя и это может меняться, судя по последним новостям)

Если вы никогда не использовали CC или подобные инструменты, то рекомендуем забить на гайды в стиле “запускаем 5-10 агентов параллельно” и поработать сначала в максимально простом режиме - без плагинов, с одной открытой вкладкой, можно через плагин для IDE. Так вы лучше поймёте сильные и слабые стороны, как лучше формулировать свои запросы и не пропустите момент, когда его нужно останавливать.

Сессии и режимы работы

Wed, 01 Jan 2025 00:00:00 +0000

Разберем на примере Claude Code важные функции при работе с агентскими системами.

Работаем с сессиями

Сессия - основной юнит работы в CC. Каждый раз, когда мы хотим решить какую-то новую задачку, мы создаём новую сессию, в контекст которой загружаются:

Системный промпт и инструменты
CLAUDE.md и правила
Описания скиллов
Описания включенных инструментов MCP
Описание кастомных субагентов
Если сессия не новая, то предыдущие сообщения

Важные команды для работы с сессиями:

/rewind - откатиться на какой-то шаг разговора
/resume - продолжить одну из прошлых сессий
/fork - форкнуть сессию (создаётся копия текущей с новым айдишником)
/rename - дать удобное название сессии вместо автоматического
/compact - можно вручную триггернуть сжатие истории сессии. Необходимо при длинных сессиях, так как контекст моделей ограничен

Авто-сжатие, кстати, постоянно теряет кучу важных деталей (например, какой скрипт с какими параметрами мы сейчас используем для дебаггинга), так что лучше такие штуки добавлять в md-файл со спецификацией задачи и сразу его прокидывать в контекст после сжатия.

Лучшие практики работы с ИИ-инструментами

Wed, 01 Jan 2025 00:00:00 +0000

В этой секции собраны ключевые советы по эффективному использованию ИИ-инструментов, подтверждённые как личным опытом, так и постами в интернете.

Совет #1: Детальное описание задачи

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

“Создай LLM-алерт-менеджер, который будет умным способом группировать алерты из Графаны в инциденты”
“Добавь в проект фичу по автоматическому анализу сообщений пользователей и изменению уровня критичности инцидента по результатам анализа”

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