Dmitry Dementiev
60182ab493
- Зачем: - следующая сессия должна управлять стоимостью субагентов без повторной загрузки длинных отчётов в контекст мастера. - Что: - разделены TOML-роли и разовые переопределения модели, уточнены fork и service tier. - добавлен файловый обмен, жизненный цикл временного каталога и нативные скелеты промптов. - синхронизированы полевые заметки и handoff с проверенной механикой Codex. - Проверка: - quick_validate.py agents/.agents/skills/codex-subagent-playbook. - git diff --cached --check. - независимое ревью: VERDICT: APPROVED.
74 lines
6.6 KiB
Markdown
74 lines
6.6 KiB
Markdown
# Полевые заметки
|
|
|
|
Читай этот файл при развитии скилла и при первом прогоне в новой среде. После
|
|
боевого прогона записывай только факты, которые меняют процесс. Когда урок
|
|
поглощён `SKILL.md` или `roles.md`, сжимай запись до одной строки со ссылкой.
|
|
|
|
## Перенесено из исходного плейбука
|
|
|
|
- Разные семейства моделей находили почти непересекающиеся классы ошибок.
|
|
Это аргумент за внешний обзор, но не обязательная часть конвейера.
|
|
- Ревьюер без прав на запись хуже проверял гипотезы, когда тестам нужны кэши
|
|
и временные артефакты. Рабочая защита: точка отсчёта Git, явный мандат не
|
|
менять исходники и сверка дерева после ревью.
|
|
- Пустой вердикт сам по себе не доказывает работу ревьюера. Нужны покрытие,
|
|
выполненные команды или другие наблюдаемые доказательства.
|
|
- Настройки модели, унаследованные от интерактивной сессии, менялись между
|
|
запусками. Для управляемой стоимости модель и глубину надо закреплять.
|
|
- Критичный отчёт фонового агента мог потеряться после его завершения.
|
|
Надёжнее сообщение плюс файл с индексом.
|
|
- Ссылка на другой скилл в файле-задаче не проверена как надёжный способ его
|
|
включить. Ключевые требования надо дублировать текстом.
|
|
- Прямой запуск внешнего Codex зависел от версии песочницы, AppArmor и сети.
|
|
Нативный конвейер не должен зависеть от внешнего CLI.
|
|
|
|
## Проверить боем
|
|
|
|
1. Выбирает ли текущий хост пользовательского агента по имени и показывает ли
|
|
фактически использованную модель после запуска новой сессии с TOML.
|
|
2. Даёт ли набор быстрых ролей экономию без повторной работы сильной модели.
|
|
3. Остаётся ли дерево неизменным после ревьюера с `workspace-write`.
|
|
4. Доступны ли ревьюеру поиск и документация при текущих сетевых разрешениях.
|
|
5. Достаточно ли общего договора возврата, чтобы мастер не открывал сырые
|
|
журналы и полные отчёты.
|
|
6. Где проходит практический порог между прямой работой и полным конвейером.
|
|
|
|
## 2026-07-10 — пробный прогон этапов 1–2
|
|
|
|
- Мастер без истории исходного плейбука поднял исследователя и ревьюера,
|
|
свёл их вывод в самодостаточную постановку и не вынес сырые журналы в
|
|
итоговый контекст.
|
|
- Конкретный tool-backed хост скрыл из схемы `spawn_agent` поля `agent_type`,
|
|
`model`, `reasoning_effort` и `service_tier`. Это ограничение той сессии,
|
|
а не Codex в целом: актуальная нативная схема поддерживает все четыре поля.
|
|
Роли в прогоне были только мандатами в промпте; мастер верно отметил
|
|
стоимость той сессии как неуправляемую.
|
|
- Исследователь обнаружил блокирующее правило `.gitignore` для будущих TOML,
|
|
которое мастер без шумного обхода репозитория мог пропустить.
|
|
- Исследователь без необходимости запустил полный набор тестов. Ограничение
|
|
«карта команд, а не полный прогон» поглощено в `SKILL.md` и `roles.md`.
|
|
|
|
## 2026-07-10 — проверка документации и исходного кода Codex
|
|
|
|
- Нативный `spawn_agent` принимает `agent_type`, `model`,
|
|
`reasoning_effort` и `service_tier`.
|
|
- Полный fork `all` наследует модель мастера и отклоняет роль, модель и
|
|
глубину. Плейбук выбирает `none` ради чистого контекста; ограниченный fork
|
|
числом технически совместим с переопределениями.
|
|
- Хост может намеренно скрыть эти поля из видимой схемы. В такой сессии
|
|
мастер не может гарантировать стоимость через нативный вызов.
|
|
- TOML-роли остаются правильным способом закрепить модель и глубину. После
|
|
их установки нужна новая сессия и проверка фактической схемы инструмента.
|
|
- `service_tier` не блокируется полным fork, но задаётся только по явному
|
|
запросу.
|
|
|
|
## 2026-07-10 — ретро утечки контекста прародителя
|
|
|
|
- Главная утечка была не в работе агентов, а в повторной передаче одного
|
|
текста через мастера: отчёт, новый промпт, повторная проверка и tool-call.
|
|
- Нативный Codex не наследует буквально поведение Claude `SendMessage`, но
|
|
длинные аргументы `spawn_agent`, `send_message` и `followup_task` всё равно
|
|
остаются в истории мастера.
|
|
- Лечение поглощено в `SKILL.md` и `prompt-templates.md`: файловый канал,
|
|
один канонический промпт и ожидание только на критическом пути.
|