Свой ИИ-агент по спецификации: пошагово от цели до прода
Habr ·
Агента сегодня можно собрать за вечер: длинный промпт, пара инструментов — и он что-то делает. Сложности начинаются потом: поведение нельзя проверить, любая правка промпта что-то ломает, а на вопрос «почему он так сделал?» ответа нет. В этой статье разберём, как спроектировать агента как инженерный объект: со спецификацией, тестами, ограничениями и метриками. Подход собран из Spec-Driven Development (SDD), моделей зрелости и автономности агентов и практики команд, которые уже внедряли агентов в разработку. Для кого: разработчики и тимлиды, которые уже работают с Claude Code, Cursor или другим агентом и хотят сделать своего — для конкретной задачи команды. Сквозной пример: агент-ревьюер, который проверяет pull request на соответствие спецификации фичи ( spec.md ) и оставляет отчёт. Он полезен сам по себе, и на нём хорошо видны все слои: чтение данных, действия с последствиями, эскалация к человеку. Примеры файлов даны в формате Claude Code, но подход переносится на любой инструмент. Что получится в конце: шесть файлов-артефактов (конституция, спека агента, скилы, эталонные примеры, правила доступа, метрики). Читать далее