- Зачем: - нужен повторяемый процесс делегирования без засорения контекста мастер-модели. - Что: - добавлен явно вызываемый скилл с этапами, договорами возврата и защитой рабочего дерева. - описаны роли, уровни стоимости, полевые заметки и handoff для следующей версии. - Проверка: - quick_validate.py agents/.agents/skills/codex-subagent-playbook. - git diff --cached --check.
4.4 KiB
4.4 KiB
Полевые заметки
Читай этот файл при развитии скилла и при первом прогоне в новой среде. После
боевого прогона записывай только факты, которые меняют процесс. Когда урок
поглощён SKILL.md или roles.md, сжимай запись до одной строки со ссылкой.
Перенесено из исходного плейбука
- Разные семейства моделей находили почти непересекающиеся классы ошибок. Это аргумент за внешний обзор, но не обязательная часть конвейера.
- Ревьюер без прав на запись хуже проверял гипотезы, когда тестам нужны кэши и временные артефакты. Рабочая защита: точка отсчёта Git, явный мандат не менять исходники и сверка дерева после ревью.
- Пустой вердикт сам по себе не доказывает работу ревьюера. Нужны покрытие, выполненные команды или другие наблюдаемые доказательства.
- Настройки модели, унаследованные от интерактивной сессии, менялись между запусками. Для управляемой стоимости модель и глубину надо закреплять.
- Критичный отчёт фонового агента мог потеряться после его завершения. Надёжнее сообщение плюс файл с индексом.
- Ссылка на другой скилл в файле-задаче не проверена как надёжный способ его включить. Ключевые требования надо дублировать текстом.
- Прямой запуск внешнего Codex зависел от версии песочницы, AppArmor и сети. Нативный конвейер не должен зависеть от внешнего CLI.
Проверить боем
- Выбирает ли текущий хост пользовательского агента по имени и показывает ли фактически использованную модель.
- Даёт ли набор быстрых ролей экономию без повторной работы сильной модели.
- Остаётся ли дерево неизменным после ревьюера с
workspace-write. - Доступны ли ревьюеру поиск и документация при текущих сетевых разрешениях.
- Достаточно ли общего договора возврата, чтобы мастер не открывал сырые журналы и полные отчёты.
- Где проходит практический порог между прямой работой и полным конвейером.
2026-07-10 — пробный прогон этапов 1–2
- Мастер без истории исходного плейбука поднял исследователя и ревьюера, свёл их вывод в самодостаточную постановку и не вынес сырые журналы в итоговый контекст.
- Доступный
spawn_agentне позволил закрепить пользовательскую роль, модель или стоимость. Роли были только мандатами в промпте; мастер честно отметил неуправляемую стоимость. - Исследователь обнаружил блокирующее правило
.gitignoreдля будущих TOML, которое мастер без шумного обхода репозитория мог пропустить. - Исследователь без необходимости запустил полный набор тестов. Ограничение
«карта команд, а не полный прогон» поглощено в
SKILL.mdиroles.md.