Содержание
  1. Чем промт для Claude Code отличается от промта для чата
  2. Как устроен рабочий промт агенту: контекст, задача, границы, проверка
  3. Промты для разбора репозитория и плана до правок
  4. Промты для тестов, исправления багов и рефакторинга
  5. Промты для коммита, PR и ревью
  6. Где хранить повторяемые промты: CLAUDE.md, команды, скиллы, и как задать системный промт
  7. Частые вопросы
Подборки и сравнения

Промты для Claude Code: готовые запросы под задачи

14 октября 2026 · 15 минут чтения

Промты для 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 и одной команды, добавьте системный промт, и следующая сессия начнётся с вашими правилами.

Читайте также

3 материала