Генератор промптов для Codex и Claude Code: что он должен делать

Генератор является переводчиком задачи, а не оракулом

Исходная мысль может быть разговорной: «почини форму и ничего не сломай». Сервис раскладывает её на цель, затронутый путь, запреты и проверку.

Он не знает скрытый репозиторий, бизнес-правило или желаемый дизайн, если их нет во входе. Недостающее следует превратить в вопрос или явное предположение.

1. Сохранить исходное намерение

Усиленная версия не расширяет работу «заодно». Если пользователь просил исправить форму, генератор не должен предлагать миграцию фреймворка.

Полезно показывать исходный текст рядом с результатом, чтобы изменение цели было заметно.

2. Отделить пробелы от фактов

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

Подстановка правдоподобного имени файла или production-команды опаснее короткого уточнения.

3. Добавить контракт для coding agent

Укажите рабочую папку, инструкции проекта, разрешённые файлы, запрещённые действия, тесты и ожидаемый артефакт. Для большой задачи добавьте последовательность карточек.

Не заставляйте модель пересказывать план в каждом сообщении. Контракт должен помогать действовать и проверять.

• сначала прочитать AGENTS.md и актуальный план;
• не откатывать чужое грязное дерево;
• редактировать только перечисленный scope;
• остановиться при реальном внешнем blocker.

4. Сформулировать приёмку

Критерии связываются с видимым результатом: build, unit, integration, browser smoke, restart или конкретный файл. Набор зависит от риска задачи.

Фраза «сделай качественно» не заменяет проверку. Генератор может предложить список, но владелец подтверждает его достаточность.

Что проверить в усиленном промпте

Сравните цель, область, факты, разрешения и критерии с исходной мыслью. Удалите лишний жаргон, если он не помогает исполнителю.

Особенно внимательно проверяйте внешние действия, production, секреты, commit и push. Генератор не может выдавать разрешение от имени пользователя.

Какую роль выполняет Effort

Effort структурирует исходный запрос и показывает готовую постановку для копирования. Он не запускает Codex или Claude Code и не проверяет их итог.

Результат полезен как первый черновик задания. Последнее решение о цели, доступах и приёмке остаётся у человека.