Промты для Claude Code: готовые запросы под задачи — это формулировки, которые вы отдаёте агенту в терминале или расширении IDE, и они отличаются от запросов к чату claude.ai тем, что агент читает файлы проекта, запускает команды и вносит правки в репозиторий. В документации проекта сказано: «Копируйте и вставляйте промпты для Claude Code, отсортированные по задачам и ролям». Ниже — рабочие формулировки под разбор кода, план, тесты, багфикс, рефакторинг, коммит, PR и ревью, а также места, где эти формулировки хранить.
Чем промт для Claude Code отличается от промта для чата
Разница в том, что у агента есть доступ к вашему рабочему каталогу. Промт для чата описывает задачу словами и ждёт текстового ответа. Промт для Claude Code адресует конкретные файлы, каталоги и команды, а результат приходит в виде правок в репозитории, вывода тестов или созданного файла. В документации проекта приведён пример: «add rate limiting to the public API and make sure existing tests still pass» — здесь задача, объект правки и критерий проверки стоят в одной строке. В том же источнике есть пример с запуском: «write the migration, run it against the dev database, and confirm the schema matches» — агент выполняет действие и сам сверяет результат.
Практическое следствие: формулировка для агента содержит три обязательных элемента, которых не требует чат. Первый — указание на файлы или каталоги, где живёт код. Второй — команда запуска, которой проверяется работа. Третий — границы правок: что трогать можно, что нельзя. В документации проекта есть пример с привязкой к существующему образцу: «add a settings page that follows the same layout as the profile page» — образец задаёт и структуру, и границы. Ещё один пример показывает измеримый критерий: «get the bundle size under 200KB and show me what you removed» — агент называет удалённое, и это можно проверить глазами.
Ещё одно отличие — контекст подключается ссылкой на файл. В документации проекта приведён короткий запрос: «why is the build failing? @build.log» — символ @ подтягивает лог в контекст, и агенту не нужно пересказывать содержимое. Тот же приём работает с любым файлом: конфигом, тестом, схемой. В чате вы бы вставили лог текстом и потеряли связь с реальным файлом на диске.
Третье отличие — формат ответа можно задать как артефакт. В документации проекта есть пример: «explain how the payment retry logic works as an HTML page with a diagram, then open it in my browser» — агент создаёт страницу и открывает её. Это уже не текстовый ответ, а результат в файловой системе. Для чата такой запрос тоже возможен, но без доступа к каталогу проекта результат останется в переписке.
Наконец, промт агенту живёт дольше одного диалога. Его сохраняют в файле проекта, и следующая сессия начинается с тем же набором правил. Об этом — отдельный раздел ниже. Пока достаточно держать в голове: чат отвечает, агент действует, и формулировка должна описывать действие с проверкой.
Как устроен рабочий промт агенту: контекст, задача, границы, проверка
Рабочая формулировка собирается из четырёх частей, и каждая закрывает свой риск. Контекст отвечает на вопрос «где смотреть». Задача — «что сделать». Границы — «что не трогать». Проверка — «как убедиться, что получилось». В документации проекта эти части видны в готовых примерах: «add rate limiting to the public API and make sure existing tests still pass» содержит задачу и проверку, «add a settings page that follows the same layout as the profile page» — задачу и границы через образец.
Разберём по частям на учебном примере. Допустим, в проекте есть модуль оплаты, и вы хотите добавить повторные попытки при ошибке сети. Контекст: назовите файл и функцию, где сейчас живёт вызов платёжного API, и файл с тестами этого модуля. Задача: опишите поведение — при сетевой ошибке повторять запрос, при отказе по карте возвращать ошибку сразу. Границы: перечислите, что менять нельзя, — публичный интерфейс модуля, схему данных, конфигурацию. Проверка: назовите команду тестов и ожидаемый результат.
Порядок действий при составлении промта выглядит так. Сначала откройте файл, который будете править, и выпишите его путь. Затем найдите тест, который покрывает это поведение, и выпишите его путь тоже. После этого сформулируйте задачу одним предложением в утвердительной форме. Добавьте строку с командой проверки. В конце перечислите запреты: файлы, интерфейсы, зависимости, которые остаются без изменений.
Частая ошибка — смешивать задачу и способ решения. Формулировка «перепиши модуль на другой библиотеке» задаёт способ, и агент начнёт менять зависимости. Формулировка «добавь повторные попытки при сетевой ошибке, публичный интерфейс оставь прежним» задаёт результат и границу. Второй вариант оставляет выбор реализации агенту и защищает совместимость.
Вторая частая ошибка — отсутствие проверки. Без строки про тесты агент считает задачу выполненной после правки файла. В документации проекта проверка встроена в примеры: там есть и «make sure existing tests still pass», и «confirm the schema matches». Добавляйте проверку в каждый промт, даже короткий.
Третья ошибка — слишком широкий контекст. Запрос «посмотри весь проект и исправь, что найдёшь» даёт агенту свободу менять десятки файлов. Узкий контекст — конкретный каталог или файл — держит правки в границах задачи и упрощает ревью.
Таблица ниже собирает четыре части промта с примером формулировки для каждой.
| Часть промта | Что задаёт | Пример формулировки |
|---|---|---|
| Контекст | Файлы, каталоги, логи | путь к модулю, путь к тесту, файл лога через @ |
| Задача | Результат в утвердительной форме | добавить повторные попытки при сетевой ошибке |
| Границы | Что остаётся без изменений | публичный интерфейс, схема данных, зависимости |
| Проверка | Команда и ожидаемый итог | запустить тесты модуля, все проходят |
Промты для разбора репозитория и плана до правок
Разбор начинается с обзорного запроса. В подборке на GitHub, собранной из документации проекта, приведён пример: «give me an overview of this codebase: architecture, key directories, and how the pieces connect». Такой промт даёт карту проекта до того, как вы что-то меняете. Ответ стоит читать как оглавление: архитектура, каталоги, связи между частями.
Дальше — точечные вопросы по конкретному файлу. В той же подборке есть формулировка: «explain what {path} does and how data flows through it. write it up as {format}» — вместо {path} подставляется путь, вместо {format} — формат вывода. Там же приведён пример подстановки: «src/scheduler/queue.ts → an HTML page with a diagram». Формат вывода выбирайте под задачу: страница с диаграммой для объяснения коллеге, обычный текст для себя.
Поиск по поведению решает вопрос «где это происходит». В подборке на GitHub приведена формулировка: «where do we {behavior}?» с примером «validate uploaded file types». Так вы находите место в коде по описанию действия, когда имя функции неизвестно. Это быстрее, чем искать по ключевым словам вручную.
Проверка последствий удаления — отдельный тип разбора. В подборке на GitHub есть формулировка: «what would break if I deleted {target}?» с примером «the retryWithBackoff helper». Ответ показывает зависимости, которые держатся на этом коде. Полезно перед чисткой устаревших модулей.
История файла объясняет, почему код выглядит именно так. В подборке на GitHub приведена формулировка: «look through the commit history of {path} and summarize how it evolved and why». Так вы получаете причины изменений.
Разбор глазами другой роли помогает увидеть сценарий целиком. В подборке на GitHub есть формулировка: «I am a {role}. walk me through what happens when a user {action}, from the UI down to the result» с примером «PM → clicks Export to PDF». Подставьте свою роль и действие пользователя — получите путь от интерфейса до результата.
План до правок — отдельный шаг, и он экономит время. В подборке на GitHub приведена формулировка: «which files would I need to touch to {change}?». Ответ перечисляет файлы, и вы видите масштаб до начала работы. Если список длинный, задачу стоит разбить на части.
Порядок разбора для незнакомого проекта выглядит так. Сначала обзор архитектуры и каталогов. Затем объяснение двух-трёх ключевых файлов. После этого поиск по поведению для той функции, которую предстоит менять. В конце — список файлов под правку. Такой порядок даёт контекст до того, как агент начнёт писать код.
Промты для тестов, исправления багов и рефакторинга
Тесты первыми — приём, который фиксирует ожидаемое поведение до правок. Формулировка строится вокруг существующего поведения: опишите сценарий, назовите файл теста и команду запуска. В документации проекта проверка встроена в примеры задач: «make sure existing tests still pass» и «confirm the schema matches». Тот же принцип работает для новых тестов: сначала тест, потом правка. Готовый промт для этого шага: напиши тесты для {путь} на текущее поведение, запусти их и покажи результат; код модуля пока не меняй. Вариант для новой функции: сначала напиши тесты для {функция}, затем реализуй её и доводи до прохождения тестов.
Исправление бага начинается с диагностики. В документации проекта приведён короткий запрос: «why is the build failing? @build.log» — лог подключается ссылкой, агент читает его и называет причину. Для ошибки времени выполнения подключайте файл с трейсом тем же способом. Диагностический промт стоит держать отдельно от правки: сначала причина, потом решение.
После диагностики формулируйте правку с проверкой. Назовите файл, опишите ожидаемое поведение, укажите тест, который должен пройти. Если баг воспроизводится тестом, добавьте его в промт как критерий. Агент внесёт правку и запустит проверку сам. Готовый промт для упавшего теста: тест {имя теста} падает, найди причину, исправь её и запусти тесты модуля. Вариант для задачи из трекера: прочитай задачу #{номер}, внеси исправление и запусти тесты.
Рефакторинг держится на границе «поведение не меняется». Формулируйте так: назовите файл или функцию, опишите цель — читаемость, разбиение на части, удаление дублирования, — и добавьте требование к тестам. В документации проекта есть пример с измеримым критерием: «get the bundle size under 200KB and show me what you removed» — здесь цель задана числом, и агент отчитывается об удалённом. Для рефакторинга без метрики критерием служит прохождение существующих тестов. Готовый промт для плана: составь план рефакторинга {модуль} под задачу {цель}, перечисли файлы, которые изменишь, и пока ничего не правь. После согласования плана: выполни этот план, публичный интерфейс оставь прежним и после каждого шага запускай тесты модуля.
Порядок работы с багом выглядит так. Сначала диагностический запрос с логом или трейсом. Затем проверка гипотезы: попросите агента показать место в коде, которое отвечает за сбой. После этого — правка с тестом. В конце — запуск полного набора тестов модуля.
Частая ошибка при рефакторинге — отсутствие тестов до начала. Если покрытия нет, сначала попросите агента написать тесты на текущее поведение, убедитесь, что они проходят, и только потом меняйте код. Так вы получаете точку сравнения.
Вторая ошибка — смешивать рефакторинг и новую функциональность в одном промте. Разделяйте: сначала изменение структуры с прохождением тестов, потом новая функция с новыми тестами. Так проще откатить неудачную часть.
Таблица ниже сопоставляет три задачи с обязательными элементами промта.
| Задача | Что назвать в промте | Критерий готовности |
|---|---|---|
| Тесты | файл теста, сценарий, команда запуска | тесты проходят |
| Багфикс | лог или трейс, файл правки, тест на баг | тест на баг проходит, остальные тоже |
| Рефакторинг | файл или функция, цель, запрет на смену поведения | существующие тесты проходят |
Промты для коммита, PR и ревью
Коммит собирается из готовых правок. Формулировка называет область: какие файлы включить, какое сообщение написать. Если в проекте есть соглашение о формате сообщений, назовите его в промте. Агент прочитает изменения и предложит текст. Готовый промт перед коммитом: проверь мои незакоммиченные изменения, отметь рискованные места и предложи сообщение коммита в формате, принятом в проекте.
Pull request требует описания, и его тоже можно поручить агенту. Назовите ветку, целевую ветку и задачу, которую решает набор правок. Попросите собрать описание из изменений: что сделано, что проверено, на что смотреть ревьюеру. Если в репозитории есть шаблон PR, укажите путь к нему — агент заполнит по образцу. Готовый промт: собери описание PR для ветки {ветка} относительно {целевая ветка}: что сделано, как проверено, на что смотреть ревьюеру; заполни по шаблону {путь к шаблону}.
Ревью чужого кода строится на вопросах. Попросите агента пройти по диффу и назвать риски: изменения в публичных интерфейсах, новые зависимости, места без тестов. Формулируйте как проверку: «пройди по изменениям и перечисли, что может сломаться». В документации проекта есть пример с отчётом об удалённом: «show me what you removed» — тот же приём работает для ревью, когда нужно увидеть состав изменений. Готовый промт для чужого PR: проверь PR #{номер}, кратко опиши, что изменилось, и перечисли замечания.
Порядок работы с коммитом выглядит так. Сначала попросите агента показать список изменённых файлов. Затем назовите, что входит в коммит. После этого попросите текст сообщения. В конце — проверка, что тесты проходят до коммита.
Для PR порядок такой. Соберите коммиты в ветку. Попросите описание из изменений. Добавьте ссылку на задачу, если она есть. Проверьте, что описание называет способ проверки для ревьюера.
Частая ошибка — коммит со смешанными изменениями. Если в рабочем каталоге лежат правки по двум задачам, разделите их на два коммита. Промт с перечислением файлов помогает это сделать: назовите файлы первой задачи, закоммитьте, затем второй.
Вторая ошибка — описание PR без способа проверки. Ревьюеру нужен порядок действий: какие тесты запустить, что открыть вручную. Добавьте этот пункт в промт, и агент включит его в описание.
Где хранить повторяемые промты: CLAUDE.md, команды, скиллы, и как задать системный промт
Повторяемые промты живут в файлах проекта. В документации проекта отдельно названы «Лучшие практики : паттерны промптирования и настройка проекта» — этот раздел описывает, как устроена настройка. Файл CLAUDE.md в корне проекта хранит правила: соглашения о стиле кода, команды запуска тестов, запреты на правку отдельных каталогов. Агент читает его в начале сессии, и вам не нужно повторять эти правила в каждом промте.
Команды хранятся в каталоге .claude/commands. Каждый файл в нём — отдельная команда с именем, и вы вызываете её коротким обращением. Так повторяющийся промт превращается в одну строку. Например, команда для запуска тестов модуля или для сборки описания PR.
Скиллы — третий способ хранения. В подборке на GitHub описаны готовые промты «в формате навыка для AI-агентов»: там собраны формулировки для разработки, отладки, ревью, анализа данных и автоматизации. Навык подключается к агенту и доступен как отдельная возможность.
Способ задать системный промт при запуске агента в прочитанных материалах Claude Code не разобран: ни документация проекта, ни обе подборки на GitHub его не описывают. Для правил, которые должны действовать в каждой сессии, документация проекта предлагает CLAUDE.md: туда записывают соглашения, чтобы каждая сессия начиналась с этого контекста.
Готовая библиотека промтов экономит время на старте. В репозитории на GitHub описана русскоязычная подборка: «Готовые промты для Claude Code на русском — 52 карточки с полями для подстановки и объяснением приёма. Работает офлайн, один HTML-файл». Там же сказано: «Под каждым промтом есть «Почему это работает» — короткое объяснение приёма». Второй репозиторий на GitHub содержит «35+ готовых промтов Claude Code для разработки, отладки, ревью, анализа данных и автоматизации».
Порядок настройки хранилища выглядит так. Сначала заведите CLAUDE.md с правилами проекта: стиль, команды, запреты. Затем вынесите в .claude/commands те промты, которые повторяете чаще всего. После этого допишите в CLAUDE.md роль и общие ограничения, которые действуют во всех задачах. В конце проверьте, что новая сессия подхватывает правила без напоминаний.
Частая ошибка — держать правила только в голове. Если соглашение о стиле не записано в CLAUDE.md, агент будет предлагать разный формат в разных сессиях. Записанное правило действует постоянно.
Вторая ошибка — перегруженный CLAUDE.md. Файл с сотней пунктов агент читает дольше и часть правил теряет в контексте. Держите там то, что относится ко всем задачам, а узкие правила выносите в команды.
Частые вопросы
Чем промт для Claude Code отличается от промта для чата?
Промт для агента адресует файлы и каталоги проекта, а результат приходит в виде правок, вывода тестов или созданного файла. Чат отвечает текстом и не имеет доступа к вашему рабочему каталогу. В документации проекта примеры содержат и задачу, и проверку в одной строке.
Как устроен рабочий промт агенту?
Он собирается из четырёх частей: контекст, задача, границы, проверка. Контекст называет файлы и логи, задача описывает результат, границы перечисляют запреты, проверка задаёт команду и ожидаемый итог. В документации проекта проверка встроена в готовые примеры.
Какие промты подходят для разбора репозитория?
Начните с обзорного запроса об архитектуре и каталогах. Затем объясните ключевые файлы и найдите места по описанию поведения. Закончите списком файлов, которые нужно править. В подборке на GitHub эти формулировки собраны по разделам.
Где хранить повторяемые промты?
Правила проекта живут в CLAUDE.md, повторяющиеся промты — в каталоге .claude/commands, готовые наборы подключаются как навыки. Системный промт задаёт роль и общие ограничения при запуске. В документации проекта есть раздел о настройке проекта.
Как исправлять баги и делать рефакторинг?
Сначала диагностика с логом или трейсом, затем правка с тестом, в конце запуск полного набора тестов модуля. Рефакторинг держится на прохождении существующих тестов. Если покрытия нет, сначала напишите тесты на текущее поведение.
Готовые промты для Claude Code: запросы под задачи стоит держать в файлах проекта. Начните с CLAUDE.md и одной команды, добавьте системный промт, и следующая сессия начнётся с вашими правилами.
