Dmitry Dementiev
60182ab493
- Зачем: - следующая сессия должна управлять стоимостью субагентов без повторной загрузки длинных отчётов в контекст мастера. - Что: - разделены TOML-роли и разовые переопределения модели, уточнены fork и service tier. - добавлен файловый обмен, жизненный цикл временного каталога и нативные скелеты промптов. - синхронизированы полевые заметки и handoff с проверенной механикой Codex. - Проверка: - quick_validate.py agents/.agents/skills/codex-subagent-playbook. - git diff --cached --check. - независимое ревью: VERDICT: APPROVED.
88 lines
5.0 KiB
Markdown
88 lines
5.0 KiB
Markdown
# Скелеты нативных промптов
|
|
|
|
Читай только тот раздел, который нужен на текущем этапе. Полный текст
|
|
задания и отчёта живёт в обменном временном каталоге; вызов агента содержит
|
|
короткую обёртку с абсолютными путями.
|
|
|
|
## Общий договор результата
|
|
|
|
Полный отчёт, независимо от канала:
|
|
|
|
```text
|
|
ИТОГ: завершено | есть вопросы | заблокировано
|
|
ДОКАЗАТЕЛЬСТВА: изменённые файлы, команды и итоговые счётчики
|
|
РЕШЕНИЯ: только вопросы, которые должен решить мастер или пользователь
|
|
НАХОДКИ: SEVERITY файл:строка — суть — как проверить
|
|
СЛЕДУЮЩИЙ ШАГ: одно конкретное действие или «нет»
|
|
```
|
|
|
|
Пустые разделы пропускаются. Сырой вывод и ход рассуждений не включаются.
|
|
При файловом канале этот договор заполняется в файле, а финальное сообщение
|
|
содержит только `ИТОГ`, счётчики и `АРТЕФАКТ: абсолютный путь`. При
|
|
`read-only` договор возвращается один раз сообщением без поля `АРТЕФАКТ`.
|
|
|
|
## Исполнитель
|
|
|
|
Файл задачи должен содержать:
|
|
|
|
```text
|
|
ЦЕЛЬ: одна проверяемая цель
|
|
КРИТЕРИИ: исчерпывающий список
|
|
ГРАНИЦЫ: разрешённые и запрещённые изменения
|
|
СНАЧАЛА ПРОЧИТАТЬ: пути к контрактам и образцам
|
|
ПРОВЕРКИ: узкие команды разработки
|
|
ОТЧЁТ: отдельный путь в обменном каталоге
|
|
```
|
|
|
|
Короткий вызов: прочитать файл задачи и выполнить буквально. Агент с записью
|
|
в обменный каталог сохраняет полный отчёт по заданному пути и финальным
|
|
сообщением возвращает состояние, счётчики и путь. `read-only`-агент
|
|
возвращает короткий результат один раз сообщением. Коммит не делать.
|
|
|
|
## Слепое ревью
|
|
|
|
Один канонический файл на всех ревьюеров:
|
|
|
|
```text
|
|
АРТЕФАКТ: задача и изменённый объём
|
|
ФОКУС: корректность, контракт, краевые случаи, честность тестов
|
|
МАНДАТ: исследовать и проверять гипотезы, исходники не исправлять
|
|
ФОРМАТ: severity, файл:строка, сценарий сбоя, доказательство, проверка
|
|
ВЕРДИКТ: APPROVED | REVISE
|
|
```
|
|
|
|
Вызов каждого ревьюера добавляет только его фокус и канал результата:
|
|
|
|
- `workspace-write`: уникальный путь файла; финальное сообщение — вердикт,
|
|
счётчики по severity и путь; исходники не менять, Git сверить до и после;
|
|
- `read-only`: короткий индекс один раз финальным сообщением, без требования
|
|
записать файл.
|
|
|
|
## Закрытие находок
|
|
|
|
Исполнителю передаются пути к исходным индексам ревью и такой короткий
|
|
мандат:
|
|
|
|
```text
|
|
По каждой находке: исправить, сузить или отклонить через контракт и проверку.
|
|
Не менять соседний объём. Полный отчёт решений записать по указанному пути.
|
|
Финальным сообщением вернуть счётчики, проверки и путь.
|
|
```
|
|
|
|
Не переписывай находки в сообщение или новый файл: исходные индексы уже
|
|
являются неизменяемым входом.
|
|
|
|
## Узкая перепроверка
|
|
|
|
Прежнему ревьюеру передаются путь к его исходному индексу и путь к отчёту
|
|
решений исполнителя:
|
|
|
|
```text
|
|
Проверь только прежние находки и новые правки рядом с ними.
|
|
По каждой: CLOSED | NOT_CLOSED | REJECTION_VALID | REJECTION_INVALID.
|
|
Полный повторный обход не выполнять.
|
|
```
|
|
|
|
Финальное сообщение: `ALL_CLOSED` или `ISSUES_REMAIN`, счётчики и путь к
|
|
файлу перепроверки.
|