Доклад от одного из инженеров Claude Code о том, как писать действительно работающие промпты.

Доклад от одного из инженеров Claude Code о том, как писать действительно работающие промпты.

Адаптируем агента

Рекомендуется перед использованием агента, провести онбординг. Можно начать с вопросов:

— как используется этот файл?

— почему у функции столько аргументов?

— посмотри git history

— что я сделал на прошлой неделе?

Это помогает понять границы агента и научиться нормально формулировать задачи.

В задачу нужно вникать самому

Идеальный сценарий для корректного ассистирования является

Explore → Plan → Confirm → Code → Verify → Commit

Не нужно сразу просить реализовать огромную фичу. Лучше сначала попросить исследовать проблему и предложить несколько вариантов и оставить принятие решения за собой.

Инструменты

Агент не обязан знать ваш инструмент заранее. Можно описывать ему внутренние bash/CLI команды и MCP-серверы. Например:

- используй наш CLI, чтобы проверить логи последнего прогона

- вызови -h, чтобы понять, как он работает

Контекст определяет качество работы

Чем больше правильного контекста дать агенту, тем умнее он работает. И его нужно структурировать. Предлагают стандартную разметку:

Enterprise policy

общие правила компании, запреты, разрешения

Global / user

личные настройки для всех проектов

Project shared

настройки проекта, которые коммитятся в Git

Project local

личные настройки внутри проекта, они не коммитятся