Изучите пять Agent Skills, плюс один бонусный, которые заставляют ИИ-агентов для написания кода работать как 10x-инженеры.
ИИ-агенты для написания кода стали ежедневным инструментом для большинства людей. Они дают вам полезный прототип, чтобы убедить вашу команду или руководство в ценности новой функции или продукта, но вскоре после этого вам приходится выпускать и поддерживать этот прототип в продакшене. Спустя полгода вы изо всех сил пытаетесь выпустить качественный продукт, несмотря на первоначальный прирост производительности. Почему?
Скорее всего, потому что ваш ИИ-кодер превратил кодовую базу в большой ком спагетти-кода, где исправление одной проблемы незаметно приводит к появлению другого бага. Функции выполнены лишь частично, а исправления ошибок поверхностны и порой ненадежны.
СМИ полны хайпа о том, что ИИ заменит программирование и инженеров-программистов, демонстрируя приложения, созданные (в один промпт?) по единственному запросу. Эти созданные на волне хайпа приложения рисуют реальность, отличную от той, с которой сталкиваются те из нас, кому приходится поддерживать и непрерывно поставлять продукты клиентам. Пока одни страдают от низкокачественного ИИ-контента («AI slop»), другие выпускают качественные продукты с помощью ИИ. Большие языковые модели значительно усовершенствовались за последние несколько месяцев, но то же самое произошло и с инструментарием вокруг ИИ, что и делает его либо ценным, либо бесполезным.
Одной из таких возможностей для ИИ-агентов являются Agent Skills.
Agent Skills — это способ сделать агентов более способными и умными, предоставив им специализированные знания или четко определенный рабочий процесс для конкретных задач. В этом посте я поделюсь пятью навыками, которые помогут вам пройти путь от идеи/прототипа до продакшена. С их помощью вы сможете построить цикл/жизненный цикл — спецификация → сборка → измерение → безопасность → диагностика → повтор 🔁 — для высококачественной веб-разработки с использованием любых ИИ-агентов для кодинга. В следующих разделах перечислены пять Agent Skills, которые я рекомендую сегодня.
1. Разработка на основе спецификаций (Specification-Driven Development)
Заявления о генерации кода с одного промпта («one-shot») заслуживают внимания лишь в СМИ. Они не работают для реальных задач в реальном мире. Чтобы ваш агент стабильно выдавал качественную работу, вам нужно документировать требования к продукту или функции.
Большинство команд разработчиков уже используют практику написания спецификации продукта (PRD) для управления разработкой и проверки того, что создается именно тот продукт, который нужен. Агентам такой документ тоже идет на пользу, так как помогает избежать галлюцинаций.
Поэтому первая рекомендация — навык skill от Эдди Османи (Addy Osmani). Вы используете его для создания документа(ов) с требованиями для проекта, новых функций, крупных изменений, неясных задач или старых кодовых баз, где агенту необходимо изучить границы, прежде чем к чему-либо притрагиваться.
Вы можете добавить его в свой проект с помощью команды skills CLI ниже:
2. incremental-implementation: сохраняйте диффы небольшими
ИИ-агенты для написания кода отлично умеют генерировать много кода, что может стать непосильной задачей для проверки человеком («human in the loop»). Они добавляют больше кода, чем удаляют, что приводит к усложнению кода и архитектуры. Моя вторая рекомендация, навык skill, — это способ направить агента на инкрементальное внесение изменений. Его использование разбивает работу на тонкие сквозные фрагменты, которые можно протестировать и откатить, с безопасными значениями по умолчанию и фича-флагами там, где это уместно.
Предположим, вы добавляете пасс-ключи (passkeys) в существующую систему входа. Заманчивым шагом со стороны агента может стать одно крупное изменение, которое затронет схему базы данных, экраны регистрации и входа, настройки, восстановление аккаунта, типы API и тесты. И это может даже не работать должным образом. Этот навык направляет агента к итеративной разработке, позволяя выявлять сквозные задачи по мере продвижения работы.
Вы можете добавить этот навык в свой проект с помощью команды:
3. Аудит и оптимизация веб-производительности
Производительность — важный аспект создания отличного продукта и пользовательского опыта. Я консультировал команды, которые обычно откладывают вопросы производительности на потом, пока продукт не будет запущен и пользователи не начнут жаловаться. ИИ-агенты и навыки облегчают интеграцию работы над производительностью в ваш инженерный процесс, а не делают её запоздалой мыслью. Вам следует добавлять её в требования к продукту при составлении PRD с помощью навыка skill и измерять её на различных этапах.
Навык skill можно использовать для измерения, диагностики или оптимизации производительности вашего веб-приложения. Агент становится умнее благодаря инструментам для записи трейсов, чтения показателей Core Web Vitals, диагностики с помощью Chrome DevTools и составления отчетов или исправления найденных проблем. Используйте этот навык, когда хотите провести аудит и исправить проблемы или оптимизировать веб-производительность.
Запустите команду ниже, чтобы добавить его в свой проект:
4. Аудит безопасности
Как и производительность, безопасность является важной составляющей веб-разработки. Моя четвертая рекомендация — навык skill, созданный разработчиками из Cloudflare. Он превращает вашего агента в аудитора безопасности, который координирует работу изолированных агентов в ходе разведки, поиска на основе покрытия, проверки кандидатов на уязвимости, структурированного вывода, независимой проверки записей и отчетов, нейтральных к цели. Вы даже можете построить на его основе собственную систему тестирования безопасности.
Обращайтесь к этому навыку, когда вам нужно провести аудит/ревью изменений аутентификации или авторизации, публичного API, периодический анализ безопасности и решить другие задачи, связанные с безопасностью.
Вы можете установить его с помощью Skills CLI, используя команду ниже:
5. Отладка (Debugging)
LLM дадут вам решение любой проблемы, которую вы им предложите, но весьма вероятно, что результат будет низкого качества. Они могут легко решать простые задачи, но терпят неудачу, когда проблема становится сложной в рамках большой кодовой базы. Точно так же, как вы выработали структуру при отладке в качестве программиста, вам необходимо дать своим агентам четкий процесс, если вы хотите получить качественный результат.
Именно здесь пригодится навык агента skill. Это навык, который дает агенту структуру для диагностики проблем и поиска решений.
Вы можете добавить его в свой проект с помощью Skills CLI:
Ваш агентный цикл/жизненный цикл разработки
Я представил вам пять Agent Skills, чтобы наделить вашего ИИ-агента различными навыками. Вы можете применить их для создания агентного жизненного цикла разработки продукта, который выглядит следующим образом:
Вы начинаете с создания документа с требованиями к продукту или спецификации функции. Затем переходите к итеративной разработке, а после — к аудиту производительности и безопасности перед деплоем в продакшен. Вот беглый обзор всех пяти Agent Skills:
Есть еще один бонусный навык, который я бы рекомендовал в дополнение к пяти основным — навык skill. Это навык, который запускает рецензента с «чистым контекстом» для важных решений, где несколько раундов проверки могут лучше снизить риск возможных ошибок в вашем дизайне или коде. Он ищет неверные предположения, крайние случаи (edge cases), скрытую связность и сценарии сбоев. Вы можете добавить его в свой проект, выполнив команду npx skills add addyosmani/agent-skills --skill doubt-driven-development.
Вам следует рассмотреть возможность использования навыка doubt-driven-development, когда вы находитесь в незнакомой кодовой базе, где ставки высоки, или когда проверка сейчас лучше отладки потом.
На самом деле хорошие Agent Skills не делают вашего ИИ-агента для кодинга быстрее. Они заставляют его выдавать лучшие результаты, предоставляя правильный контекст и структуру.
Вам не нужно 50 навыков, чтобы начать. Выберите один из шести предложенных мною и постепенно внедряйте их в свой проект. Вот еще несколько ресурсов для дальнейшего чтения и изучения:
- Открытая спецификация Agent Skills
- Каталог Agent Skills от Addy Osmani
- Репозиторий Cloudflare Agent Skills












