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