- Зачем: - следующая сессия должна управлять стоимостью субагентов без повторной загрузки длинных отчётов в контекст мастера. - Что: - разделены TOML-роли и разовые переопределения модели, уточнены fork и service tier. - добавлен файловый обмен, жизненный цикл временного каталога и нативные скелеты промптов. - синхронизированы полевые заметки и handoff с проверенной механикой Codex. - Проверка: - quick_validate.py agents/.agents/skills/codex-subagent-playbook. - git diff --cached --check. - независимое ревью: VERDICT: APPROVED.
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, счётчики и путь к
файлу перепроверки.