Files
dotfiles/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md
T
Dmitry Dementiev 60182ab493 fix(agents): исправлена оркестрация моделей и контекста
- Зачем:
  - следующая сессия должна управлять стоимостью субагентов без повторной загрузки длинных отчётов в контекст мастера.
- Что:
  - разделены TOML-роли и разовые переопределения модели, уточнены fork и service tier.
  - добавлен файловый обмен, жизненный цикл временного каталога и нативные скелеты промптов.
  - синхронизированы полевые заметки и handoff с проверенной механикой Codex.
- Проверка:
  - quick_validate.py agents/.agents/skills/codex-subagent-playbook.
  - git diff --cached --check.
  - независимое ревью: VERDICT: APPROVED.
2026-07-10 17:59:15 +03:00

5.0 KiB

Скелеты нативных промптов

Читай только тот раздел, который нужен на текущем этапе. Полный текст задания и отчёта живёт в обменном временном каталоге; вызов агента содержит короткую обёртку с абсолютными путями.

Общий договор результата

Полный отчёт, независимо от канала:

ИТОГ: завершено | есть вопросы | заблокировано
ДОКАЗАТЕЛЬСТВА: изменённые файлы, команды и итоговые счётчики
РЕШЕНИЯ: только вопросы, которые должен решить мастер или пользователь
НАХОДКИ: SEVERITY файл:строка — суть — как проверить
СЛЕДУЮЩИЙ ШАГ: одно конкретное действие или «нет»

Пустые разделы пропускаются. Сырой вывод и ход рассуждений не включаются. При файловом канале этот договор заполняется в файле, а финальное сообщение содержит только ИТОГ, счётчики и АРТЕФАКТ: абсолютный путь. При read-only договор возвращается один раз сообщением без поля АРТЕФАКТ.

Исполнитель

Файл задачи должен содержать:

ЦЕЛЬ: одна проверяемая цель
КРИТЕРИИ: исчерпывающий список
ГРАНИЦЫ: разрешённые и запрещённые изменения
СНАЧАЛА ПРОЧИТАТЬ: пути к контрактам и образцам
ПРОВЕРКИ: узкие команды разработки
ОТЧЁТ: отдельный путь в обменном каталоге

Короткий вызов: прочитать файл задачи и выполнить буквально. Агент с записью в обменный каталог сохраняет полный отчёт по заданному пути и финальным сообщением возвращает состояние, счётчики и путь. read-only-агент возвращает короткий результат один раз сообщением. Коммит не делать.

Слепое ревью

Один канонический файл на всех ревьюеров:

АРТЕФАКТ: задача и изменённый объём
ФОКУС: корректность, контракт, краевые случаи, честность тестов
МАНДАТ: исследовать и проверять гипотезы, исходники не исправлять
ФОРМАТ: severity, файл:строка, сценарий сбоя, доказательство, проверка
ВЕРДИКТ: APPROVED | REVISE

Вызов каждого ревьюера добавляет только его фокус и канал результата:

  • workspace-write: уникальный путь файла; финальное сообщение — вердикт, счётчики по severity и путь; исходники не менять, Git сверить до и после;
  • read-only: короткий индекс один раз финальным сообщением, без требования записать файл.

Закрытие находок

Исполнителю передаются пути к исходным индексам ревью и такой короткий мандат:

По каждой находке: исправить, сузить или отклонить через контракт и проверку.
Не менять соседний объём. Полный отчёт решений записать по указанному пути.
Финальным сообщением вернуть счётчики, проверки и путь.

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

Узкая перепроверка

Прежнему ревьюеру передаются путь к его исходному индексу и путь к отчёту решений исполнителя:

Проверь только прежние находки и новые правки рядом с ними.
По каждой: CLOSED | NOT_CLOSED | REJECTION_VALID | REJECTION_INVALID.
Полный повторный обход не выполнять.

Финальное сообщение: ALL_CLOSED или ISSUES_REMAIN, счётчики и путь к файлу перепроверки.