Как писать код с агентом через спецификацию: урок Kiro
SEO title: Как писать код с агентом через спецификацию: Kiro и spec-driven подход
Meta description: Что дает Kiro: требования, дизайн, задачи, правила проекта и агентские хуки. Как превратить просьбу к ИИ в проверяемую спецификацию.
Когда ИИ-агент пишет код по одной общей просьбе, он часто угадывает. Иногда удачно, иногда нет. Для прототипа это терпимо. Для продукта, где есть требования, архитектура, тесты, права и команда, нужен другой вход: сначала спецификация, потом код.
Kiro интересен не как еще один редактор кода. Он показывает более зрелый способ работы с агентом: промпт превращается в требования, дизайн и список задач, а правила проекта и хуки помогают удерживать качество. Это близко к тому, как реальная команда передает работу разработчику.
## Что произошло
В официальном описании Kiro говорится о разработке через спецификации: система превращает запрос в структурированные требования, дизайн и задачи. В документации Kiro рядом с этим есть steering-файлы и agent hooks - правила и автоматические действия, которые помогают агенту соблюдать стандарты проекта.
## Почему это важно для работы
Практический смысл выходит за пределы конкретного редактора. Командам не хватает не только сильных моделей, а нормального входа для работы. Если задача звучит как 'сделай личный кабинет', агент начнет заполнять пустоты. Если есть требования, сценарии, ограничения, структура данных и критерии готовности, ИИ становится исполнителем в понятном процессе.
| Вопрос | Как думать | Что проверять |
|---|---|---|
| --- | --- | --- |
| Требования | Что пользователь должен получить | нет ли противоречий |
| Дизайн | Как будет устроено решение | понятны ли данные и границы |
| Задачи | Что делать по шагам | можно ли проверять отдельно |
| Хуки | Какие проверки запускать автоматически | не обходятся ли стандарты |
## Какой прием из этого получается
Рабочий прием: перед задачей для агента написать короткую спецификацию. В ней должны быть пользовательский результат, ограничения, данные, проверка, список шагов и критерий готовности. После этого агент получает не просьбу, а маршрут. Его ответ проще принять, отклонить или разбить на итерации.
Rich block render error: expected '<document start>', but found '<block sequence start>'
in "<unicode string>", line 4, column 3:
- "Что подать на вход: цель, пол ...
^
title: Рабочая карточка
steps:
- "Когда использовать: для кода, автоматизации, интеграций и любых задач дороже быстрого прототипа."
- "Что подать на вход: цель, пользовательские сценарии, ограничения, данные, тесты и критерий готовности."
- "Что сделать: попросить агента сначала оформить требования и задачи, а не писать код сразу."
- "Какой результат получить: план реализации, который можно проверить до генерации кода."
- "Как проверить качество: каждый пункт спецификации должен иметь понятный тест или ручную проверку."
- "Когда не использовать: для одноразовых экспериментов, где цена ошибки низкая."
- "Какой навык собрать: помощник, который из сырой идеи делает спецификацию для ИИ-разработки."## Где граница
Спецификация не гарантирует качество сама по себе. Плохие требования приведут к плохому коду, только более аккуратно оформленному. Человеку все равно нужно принимать архитектурные решения и проверять результат.
Rich block render error: mapping values are not allowed here
in "<unicode string>", line 2, column 114:
... овки. Kiro ценен как напоминание: спецификация становится интерф ...
^
label: Редакционный вывод
body: Сильный агент начинается не с самой мощной модели, а с ясной постановки. Kiro ценен как напоминание: спецификация становится интерфейсом между человеком и ИИ-разработкой.## Что сделать сегодня
Перед следующей задачей для кодового агента напишите четыре блока: пользовательский результат, ограничения, шаги, проверка. Попросите ИИ сначала улучшить эту спецификацию, а только потом писать код.
## Источники
