Вики · Начало пути
Первый свиток
Свиток (промпт) — не запрос в поисковик и не команда. Это техническое задание агенту, который может читать файлы, запускать команды и менять код. Разница между удачной и неудачной сессией задаётся здесь, до первого хода.
Четыре поля, которые держат задачу
Промпт, переживающий прогон без надзора, состоит из четырёх частей.
- Задача — что сделать, в одном предложении.
- Готово, когда — измеримое конечное состояние. Не «код стал чище», а то, что имеет ровно два значения: тесты зелёные, сборка вышла с кодом 0, очередь пуста.
- Проверка — конкретная команда, которой агент это докажет, и требование показать её вывод.
- Границы — что не должно измениться по дороге: каталог, файлы, конфигурация.
Пятый элемент — не про условие, а про поведение: скажите прямо, что делать, если проверка не прошла. Иначе агент имеет полное право сообщить о неудаче и остановиться, и формально будет прав.
Задача: <что сделать>.
Готово, когда: <измеримое конечное состояние>.
Проверка: выполни <команда> и покажи вывод целиком.
Границы: не меняй <что не должно измениться>.
Если проверка не прошла — исправляй причину (не подавляй ошибку)
и повторяй; не сообщай о готовности до зелёного вывода.Механику «почему без проверки агент останавливается на «выглядит готовым»» разбирает Замкнутый цикл.
Конкретность вместо усилителей
Слова «тщательно», «аккуратно», «ничего не сломай» не добавляют сигнала. Добавляет — ссылка на источник, на образец и на симптом.
| Слабо | Сильно |
|---|---|
«добавь тесты для foo» | «напиши тест на foo для случая, когда пользователь разлогинен; моки не используй» |
| «почему у этого класса странный API» | «посмотри историю git этого файла и объясни, как API стал таким» |
| «добавь виджет календаря» | «посмотри, как сделаны существующие виджеты, возьми <файл> за образец и следуй тому же паттерну» |
| «почини баг логина» | «пользователи сообщают: вход падает после истечения сессии. Смотри <каталог>, особенно обновление токена. Сначала напиши падающий тест, воспроизводящий проблему, потом чини» |
Расплывчатый промпт полезен ровно в одном режиме — разведочном, когда вы готовы корректировать курс и хотите увидеть, как агент интерпретирует задачу.
Как подать материал
@перед путём — агент прочитает файл до ответа, вам не нужно описывать, где лежит код;- изображения вставляются прямо в поле ввода — скриншот макета или ошибки работает лучше абзаца описания;
- данные можно передать конвейером:
cat error.log | claude -p "объясни причину"; - URL документации допустимы, но домен придётся разрешить в настройках прав — см. Круг дозволенного.
Границы одного свитка
Один промпт — одна тема. Не потому что «так красивее», а потому что всё прочитанное и выполненное остаётся в котле и влияет на следующие ходы: Котёл.
Если тема крупная — не растягивайте промпт, а разбейте на этапы. Рабочий приём: попросить агента проинтервьюировать вас (инструмент AskUserQuestion) и записать спецификацию в файл, а исполнять её в новой, чистой сессии. Самая полезная спецификация называет файлы и интерфейсы, явно говорит, что вне области задачи, и заканчивается сквозной проверкой.
Если задача требует сначала разобраться, а потом менять — начинайте не с промпта, а с режима плана: Чертёж.
Условие на всю сессию
Когда критерий должен держаться не один ход, а до конца работы, его место не в тексте промпта, а в команде /goal: отдельный оценщик проверяет условие после каждого хода и сам запускает следующий, пока условие не выполнено. Условие принимает до 4000 символов и должно быть таким, чтобы его подтверждал вывод самого агента: оценщик не запускает команд и не читает файлы, он судит по разговору.
Сверено по
Прокачаться: юниты