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

6.2 KiB

Роли и возможности среды

Читай этот файл при выборе агента, модели, глубины рассуждения или способа передачи истории. Сначала посмотри на схему доступного инструмента: она описывает текущую среду точнее датированных заметок.

Распределение ответственности

  • Координатор держит замысел, выбирает устройство решения, разрешает спорные вопросы и принимает результат. Это роль ведущего текущей задачи.
  • Sol или Terra обычно реализует задачу, исследует техническую неопределенность, проверяет код и исправляет подтвержденные дефекты.
  • Помощник удерживает механику и объемный вывод вне контекста координатора.
  • Luna - обычный выбор для такой помощи. Она может просмотреть задачи, комментарии и историю Git, сверить фактическое состояние и подтвержденные чекбоксы. Ей также подходят журналы, трассы, вывод тестов, планы запросов и сопровождение внешнего ревьюера. Если это разрешено, ей можно поручить коммиты, отправку ветки и уборку.

Эти назначения служат отправной точкой. Состав собирай под задачу; один агент может совмещать совместимую работу. Выбор определяется вкладом в задачу и качеством доступных моделей. Название роли вторично.

Свежая Astra полезна для отдельной проверки формы и соразмерности. Claude Opus добавляет независимый взгляд другого семейства. Основания выбора задает основная оптика.

Если партнер поручил группу связанных тикетов, выбирай готовые к работе по их существующим зависимостям. Перед выдачей зависимого тикета убедись, что результат предшественника проверен и доступен исполнителю.

Модель и глубина

Модель и глубину рассуждения выбирай независимо, если среда открывает обе ручки. Для технических поручений Terra обычная отправная точка - medium. Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя.

Для любой роли существенная неопределенность, необратимое решение или высокая цена тихой ошибки могут обосновать high либо более сильную доступную настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель - когда не хватило качества суждения. Основание должно следовать из задачи, а не из названия роли.

Не обещай, что запрошенная модель или глубина фактически применились, если инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска, когда они доступны; иначе называй настройку запрошенной.

Текущая схема Codex

На момент обновления доступный spawn_agent принимает model, reasoning_effort и fork_turns. Значение fork_turns может быть none, all или положительным числом строкой.

  • none дает свежий контекст. Используй его для независимого исходного ревью и для роли, которой достаточно самодостаточного краткого задания.
  • Положительное число передает ограниченный хвост истории. Это полезно, когда без ближайшего контекста поручение раздуется, а вся история не нужна.
  • all передает полную историю и наследует модель и глубину координатора. В этом режиме явные переопределения модели и глубины отклоняются.

Для явного выбора модели или глубины используй none либо ограниченную историю. Продолжение через followup_task сохраняет полезный контекст уже созданного агента; короткое уточнение работающему агенту передается сообщением. Новый свежий обзор запускается отдельным агентом с none.

Эти сведения описывают текущий интерфейс координации. После изменения схемы заново проверь доступные поля. Файлы локальных ролей, установка моделей и внешняя настройка среды в работу этого скилла не входят. Владение общим состоянием задает основная оптика.