Files
dotfiles/agents/.agents/skills/codex-subagent-playbook/references/roles.md
T
ddadmin cd867fcc1f docs(skills): уточнены выбор Luna и сопровождение ревью
- Зачем:
  - связать выбор помощника и глубины с фактической ценой ошибки и сохранять контекст координатора.
- Что:
  - уточнен свободный выбор `high` для Luna и выделение отдельного помощника для долгой линии Claude;
  - описаны события наблюдения, необязательный минутный опрос и прозрачная передача результата;
  - добавлены подтвержденные факты прямой передачи девяти находок и предпочтения Luna `high`.
- Проверка:
  - `git diff --check`;
  - проверены только три разрешенных файла и ссылки на комментарии #236:2840 и #236:2845;
  - ранее пройдены адресные проверки и нормализованный `quick_validate`.
2026-09-06 13:55:28 -04:00

6.2 KiB

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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