Спецификацией для ИИ называют документ, который описывает задачу так, чтобы модель или агент выполняли её предсказуемо, а результат можно было проверить: что на входе, что на выходе, какие правила нельзя нарушать и как понять, что готово. Она живёт отдельно от чата и переживает любую сессию.
Промптом называют инструкцию или просьбу в разговоре. Обычно он решает конкретную задачу и остаётся частью этой сессии. Спецификацию модель читает в начале каждой сессии, её обновляют, когда меняются правила, и по ней же потом проверяют работу. Хороший промпт делает удачным один ответ. Спецификация делает предсказуемой всю работу.
У разработчиков эту дисциплину держит инженерная среда: задачи в трекере, ревью кода, тесты. У руководителя или небольшой компании без инженерного отдела такой среды нет, и её заменяет страница спецификации.
Для одной задачи всё это часто помещается на страницу.
Задачу модели обычно ставят как коллеге, который всё знает. Модель знает меньше коллеги и не переспрашивает, она додумывает. Результат выглядит правдоподобно и делает не то. Дальше правки идут по кругу: чинишь одно, ломается соседнее. Шуточных роликов об этом в интернете столько, что они стали отдельным жанром. Смешно, потому что правда.
Вторая причина в устройстве самих моделей. У них ограниченное контекстное окно: чем больше в сессии документов, сообщений и новых инструкций, тем труднее модели удерживать прежние договорённости. Разговорная постановка задачи обычно остаётся частью конкретного чата. Спецификация лежит отдельно, и её можно дать модели заново.
До того как писать спецификации, я ставил задачи моделям так же, как все: разговорно, по ходу дела. Примерно к пятому-десятому ответу начиналась каша. Модель забывала принятые решения, переписывала то, что трогать было нельзя, путалась в длинных документах. Так было почти в каждом проекте, с любым агентом.
Из этого опыта вырос ANSS, открытый стандарт спецификаций для работы с ИИ. В моих проектах после перехода на него качество результата заметно выросло. Идеальным он не является, как и сами модели, но подход рабочий, и я пользуюсь им в работе.
Даже этот словарь пишется так же. Когда в чате накапливается слишком много версий, мы сводим все решения в один файл и открываем с него новую сессию.
Кто пишет спецификацию: заказчик, исполнитель или вместе, и кто её утверждает. Где она лежит и кто её обновляет, когда меняются правила. Насколько подробно её писать: для одной задачи хватает страницы, для цепочки агентов, передающих работу друг другу, нужен стандарт вроде ANSS.
Связанные термины: Критерии приёмки · Инвариант · Промпт · Контекстное окно
Нужно описать задачу для ИИ или для подрядчика на одной странице? Спецификация →