Files
dotfiles/agents/.agents/skills/codex-subagent-playbook/references/roles.md
T
ddadmin 0990ac6ce4 docs(skills): уточнена работа помощников координатора
- Зачем:
  - экономить контекст координатора, сохраняя проверяемость внешних ревью и объемных операций.
- Что:
  - описана механика Luna для шумного вывода, необязательного Opus-ревью и коротких отчетов;
  - уточнены изоляция контекста помощника, жизненный цикл Claude и передача разрешения и отчетов;
  - добавлены наблюдения прогона и границы для частоты опроса и приема результатов.
- Проверка:
  - git diff --check;
  - проверены ссылки и настройки навыка;
  - quick_validate на нормализованной копии без неподдерживаемого валидатором ключа `disable-model-invocation`.
2026-09-06 13:33:36 -04:00

71 lines
6.3 KiB
Markdown

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