Files
dotfiles/agents/.agents/skills/codex-subagent-playbook/references/roles.md
T
ddadmin cbdbedb53c docs(skills): уточнены настройки Luna и сопровождение ревью
- Зачем:
  - Зафиксировать единые правила выбора глубины Luna для технических поручений и сопровождения внешнего ревью.
- Что:
  - Указана отправная настройка `high` для технических поручений Luna.
  - Уточнено, что Luna готовит краткие итоги внешнего Claude-ревью и может продолжать сохранённую сессию.
- Проверка:
  - git diff --check.
  - Проверены состав изменений и формат сообщения Conventional Commits.
2026-09-06 14:06:53 -04:00

6.2 KiB

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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