Сенсей Эдди Османи, ведущий инженер Google и разработчик Gemini, опубликовал подробный гайд по написанию спецификаций для AI-агентов на основе своего опыта. 😱
Всего есть пять основных принципов. Записываем:
🟢 Начинайте с общей идеи, а детали пусть предложит сам ИИ. Дело в том, что агенты хороши в доработке деталей, но им нужна четкая миссия, цель. Разрабатывать можно и нужно в Plan mode.
🟢 Структурируйте спецификацию как нормальный PRD/SRS. Прописывайте разрешенные команды, стиль, как проводить тесты, какой фреймворк вы используете, где находятся тестовые файлы и какие ожидания существуют.
🟢 Делите задачу на модули и контекст, а не ваваливайте всё в один огромный промпт. С гигапромптом модель может потерять фокус из-за «проклятия инструкций» — слишком много директив, из-за которых она не будет следовать хорошо ни одной из них.
🟢 Встраивайте самопроверки, ограничения и оставляйте место для человеческой экспертизы. Самое важное — прописывайте границы, то есть то, к чему агент никогда не должен прикасаться.
🟢 Тестируйте, итеративно улучшайте и развивайте документацию для агентов. Если вы думали, что можно один раз написать и забыть, то у нас плохие новости. И да, помните — если агент создал что-то, что проходит тесты, то это не означает, что это правильно и безопасно.
Гайд действительно золотой — внутри также есть промпты, понятные примеры и ответ на вопрос, когда лучше использовать одного агента, а когда нужны несколько.
Становимся топовым менеджером ИИ-агентов
@xor_journal