Как я пишу production-код с AI-агентом 😎
ContextЯ работаю senior js разрабом в крупном банке и использую Codex по личной подписке. Мы пилим внутренний проект для хранения и генерации финансовой отчетности. Команда суммарно из ~15 человек. В том числе душный (в хорошем смысле) техлид-эксперт, который ОЧЕНЬ внимательно ревьют весь код на js, который мы пишем
(бро, если ты это читаешь, то не обижайся, на самом деле я очень ценю твою духоту ❤️).Как я делал раньшеЯ исходил из логики, что агенту сложно удержать весь контекст в одной сессии, поэтому я разбивал большую задачу на кусочки и пилил ее поэтапно вместе с агентом.
Это выглядело примерно так:
- я пишу небольшой промпт
- агент пишет немножко кода
- я проверяю код
- я вношу правки, если считаю нужным
- создаю новую сессию
- пишу следующий промпт и так по кругу
В целом, неплохой подход. Он достаточно простой и позволяет не переполнять контекст. Мне удавалось добиваться результатов, когда я вносил миниум правок в код агента и обходился только промптами.
Но у него есть несколько существенных недостатков:
1. Агент не имеет контекста всей задачи и образа конечного результата. Из-за этого, бывает такое, что он начинает двигаться не в ту сторону. Мне приходится писать ему новые промпты, пытаясь изменить то, что он уже сделал. Агент пишет еще больше кода на основе своих предыдущих неправильных решений. Я начинаю тонуть в этом объеме строк и уже сам не понимаю, как именно должен выглядеть желаемый результат.
2. Сессия кодинга агентом занимает минут 5-10 максимум. Сидеть и тупить в экране в течение 5 минут как-то скучно и непродуктивно. Я пытаюсь переключаться на какие-то другие задачи, но камон, что можно серьезного сделать за 5-10 минут?
(подрочить конечно можно, но на 3-й раз за час надоедает 🤩) Из-за этого я постоянно находился в полуСДВГшном состоянии, пытаясь быстро переключаться между разными задачами, по 5-10 минут на каждую. Затея бестолковая, я только быстрее уставал и не мог нормально сфокусироваться.
Как я делаю сейчасВнедрить полноценный spec driven на уровне команды у меня пока не вышло, но на уровне своего собственного процесса разработки я пришел к следующей модели работы.
Если задача оценена больше, чем в 1 сторипоинт (сторипоинт = рабочий день), то перед тем, как писать команды агенту, я провожу сессию глубокого планирования и формирования дизайн-спеки фичи для агента. Этот процесс может занимать у меня несколько часов, а то и дней, но зато на выходе я получаю максимально подробную инструкцию, что именно нужно сделать и в чем конечный смысл фичи.
Для этого я использую не просто plan mode, а скилл
grill-with-docs. Он оказался весьма удобным для обдумывания задачи и поиска неточностей и противоречий.
После того, как спека готова, я создаю новую сессию и запускаю агента с одним простым промптом
implement. И он может 40-60 минут пыхтеть над фичей. А я в это время могу заняться другими важными задачами.
После того, как агент закончил, я внимательно смотрю, что он наворотил и, о чудо, результат в большинстве случаев получается гораздо качественнее, чем с моим старым подходом.
Если меня что-то кардинально не устраивает в результате, я теперь не пытаюсь исправить последствия. Я просто сношу весь написанный код, правлю спеку и перезапускаю генерацию кода. Не знаю, насколько это разумно с точки зрения использования токенов, но мое время это точно экономит.
Но даже после всего этого, я внимательно читаю ВЕСЬ код, который написал агент, за исключением может быть тестов — их я читаю весьма поверхностно. Ибо если не уследить за агентом, то на ревью мне прилетит пара десятков комментов от того самого душного техлида.
———
Вот такой мой текущий статус использования агентов на реальной работе. Не претендую на роль эксперта по AI, просто делюсь своим опытом 👨🔬
