Files
ddadmin ba9f4736ff docs(codex-subagent-playbook): обновлены правила выбора моделей
- Зачем:
  - уточнены роли моделей и подход к их выбору в конвейере субагентов.
- Что:
  - добавлена матрица цены, интеллекта, вкуса и качества текста.
  - Terra назначена отправной точкой для технических задач.
  - дополнены наблюдения о ревью и длительных сессиях Claude.
- Проверка:
  - git diff --cached --check.
2026-09-08 11:06:04 -04:00

70 lines
6.2 KiB
Markdown

# Роли и возможности среды
Читай этот файл при выборе агента, модели, глубины рассуждения или способа
передачи истории. Сначала посмотри на схему доступного инструмента: она
описывает текущую среду точнее датированных заметок.
## Распределение ответственности
- **Координатор** держит замысел, выбирает устройство решения, разрешает
спорные вопросы и принимает результат. Это роль ведущего текущей задачи.
- **Sol или Terra** обычно реализует задачу, исследует техническую
неопределенность, проверяет код и исправляет подтвержденные дефекты.
- **Помощник** удерживает механику и объемный вывод вне контекста координатора.
- **Luna** - обычный выбор для такой помощи. Она может просмотреть задачи,
комментарии и историю Git, сверить фактическое состояние и подтвержденные
чекбоксы. Ей также подходят журналы, трассы, вывод тестов, планы запросов и
сопровождение внешнего ревьюера. Если это разрешено, ей можно поручить
коммиты, отправку ветки и уборку.
Эти назначения служат отправной точкой. Состав собирай под задачу; один агент
может совмещать совместимую работу. Выбор определяется вкладом в задачу и
качеством доступных моделей. Название роли вторично.
Свежая Astra полезна для отдельной проверки формы и соразмерности. Claude Opus
добавляет независимый взгляд другого семейства. Основания выбора задает
[основная оптика](../SKILL.md).
Если партнер поручил группу связанных тикетов, выбирай готовые к работе по
их существующим зависимостям. Перед выдачей зависимого тикета убедись, что
результат предшественника проверен и доступен исполнителю.
## Модель и глубина
Модель и глубину рассуждения выбирай независимо, если среда открывает обе
ручки. Для технических поручений Terra обычная отправная точка - `medium`.
Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя.
Для любой роли существенная неопределенность, необратимое решение или высокая
цена тихой ошибки могут обосновать `high` либо более сильную доступную
настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель -
когда не хватило качества суждения. Основание должно следовать из задачи, а не
из названия роли.
Не обещай, что запрошенная модель или глубина фактически применились, если
инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска,
когда они доступны; иначе называй настройку запрошенной.
## Текущая схема Codex
На момент обновления доступный `spawn_agent` принимает `model`,
`reasoning_effort` и `fork_turns`. Значение `fork_turns` может быть `none`,
`all` или положительным числом строкой.
- `none` дает свежий контекст. Используй его для независимого исходного ревью
и для роли, которой достаточно самодостаточного краткого задания.
- Положительное число передает ограниченный хвост истории. Это полезно, когда
без ближайшего контекста поручение раздуется, а вся история не нужна.
- `all` передает полную историю и наследует модель и глубину координатора.
В этом режиме явные переопределения модели и глубины отклоняются.
Для явного выбора модели или глубины используй `none` либо ограниченную
историю. Продолжение через `followup_task` сохраняет полезный контекст уже
созданного агента; короткое уточнение работающему агенту передается сообщением.
Новый свежий обзор запускается отдельным агентом с `none`.
Эти сведения описывают текущий интерфейс координации. После изменения схемы
заново проверь доступные поля. Файлы локальных
ролей, установка моделей и внешняя настройка среды в работу этого скилла не
входят. Владение общим состоянием задает [основная оптика](../SKILL.md).