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

70 lines
6.2 KiB
Markdown

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