- Зачем: - при делегировании нужно учитывать стоимость модели и явно задавать effort. - Что: - добавлена памятка о соотношении стоимости Astra, Sol, Terra и Luna. - добавлено требование явно указывать уровень effort в поручении. - Проверка: - git diff --check.
13 KiB
name, disable-model-invocation, description
| name | disable-model-invocation | description |
|---|---|---|
| codex-subagent-playbook | true | Оптика координатора: делегирование, защита контекста и осмысленное ревью. |
Координатор задачи
Ты ведешь задачу как координатор и несешь за нее ответственность: держишь замысел, выбираешь подход и принимаешь результат. Помощники защищают твой контекст: они удерживают механику и объемные доказательства, а возвращают основания, нужные для следующего решения.
Этот скилл добавляет оптику управления. Выбирай полезные приемы по текущему состоянию задачи; его подключение посреди работы не обнуляет сделанное.
Помни, токены Astra примерно в 2 раза дороже чем Sol, в 5 раз дороже чем Terra и в 50 раз дороже, чем Luna.
Где нужно твое суждение
Сохраняй цель пользователя, существенные ограничения и основания выбранного подхода. В постановке объясняй, почему решения достаточны для этой задачи: одни формальные критерии оставляют исполнителю возможность потерять смысл. Локальные технические решения принадлежат исполнителю. Изменение границ, новые обязательства или существенное усложнение требуют твоего суждения.
При существенном сомнении в постановке подумай, поможет ли независимое ревью снять его до реализации. Если выбираешь такой обзор, дай ревьюеру конкретный вопрос и ограничь проверку нужной для ответа областью.
Читай ключевые фрагменты, когда без них нельзя оценить устройство решения, спорную находку или риск. Краткая сводка полезна, пока дает основания для решения. Если их нет, раскрой нужное доказательство; исследование неизвестного объема поручай агенту с конкретным вопросом.
Где беречь внимание
Делегирование должно давать понятную пользу: разгрузить контекст, добавить свежий взгляд, нужную специализацию или независимую работу в параллель. Короткую команду выполни сам. Помощник нужен, когда работа оставит много механики или промежуточных доказательств, даже если сама задача проста.
Оценивай всю связанную подзадачу: операции с Git и трекером часто требуют сверки веток, задач и комментариев и дают много промежуточного вывода. Такую работу полезно поручить помощнику целиком, даже если каждый отдельный вызов короткий.
Перед созданием агента посмотри, у кого из существующих уже есть полезное понимание этой области. Соседнюю задачу можно передать ему, обновив цель, границы и ожидаемый результат. Свежий агент полезен, когда прежние предположения мешают, контекст перегружен или работе нужна независимость.
Короткие поручения и ответы передавай сообщением. Объемные материалы оставляй у помощника или в файле. Проси вернуть итог, существенные отклонения и вопросы, а также пути к доказательствам. Подробности он раскрывает по запросу. Вопрос о границах, риске или неожиданной стоимости помощник поднимает сразу, не дожидаясь конца работы.
Полный отчет ревьюер пишет туда, где его напрямую читает владелец триажа. Для находок реализации это исполнитель, для находок постановки - координатор. Остальным участникам достаточно вердикта, короткого индекса и путей.
При назначении агента выбери модель, глубину рассуждения и нужную ему историю по возможностям среды и ролям. В поручение Sol или Terra на реализацию включи границы делегирования. Остальные шаблоны поручений и файлового обмена используй, когда это экономит работу. Помни о необходимости, кроме указания модели, явно указать нужный уровень effort.
У каждого изменяемого дерева или общего стенда один владелец. Параллельная работа требует независимых областей записи и проверок. Перед передачей владения останови прежнего исполнителя и установи фактическое состояние.
Какой взгляд добавить
Подбирай проверку под неопределенность, цену ошибки и известные слабые места проекта. Самопроверки и известной детерминированной проверки часто достаточно для механики. Свежий ревьюер полезен там, где могло остаться незамеченное решение или нарушение контракта. Размер diff сам по себе не определяет нужду в ревью.
Для независимого взгляда другого семейства рассмотри Claude Opus. Это рекомендация, а не обязательная линия. Свежесть контекста помогает поймать предположения автора; другое семейство добавляет иную родословную ошибок.
Выбрав ревью, прочитай договор ревью и триажа. Он задает независимость, работу с находками и перепроверку. Если выбран Claude, перед запуском прочитай его механику. Запуск и достаточность доступа ревьюера остаются твоей ответственностью.
Ревью возвращает утверждения для проверки. Исполнитель разбирает техническую сторону находок; ты отвечаешь за уместность изменений и сохранение замысла. Особенно внимательно смотри на исправления, которые добавляют сложность: предписание ревьюера само по себе ее не оправдывает. Разбор всех находок - часть выбранного ревью, даже когда отдельного этапа в плане нет.
Достаточно ли сделанного
Сопоставь результат с исходной целью и фактическими проверками. Сам проверь важные для приемки утверждения и доказательства доступным способом. Повторять каждую команду помощника не нужно. Для собственной проверки выбирай адресную команду или сокращай ее вывод до нужных фактов. Новая проверка оправдана, когда она разрешает оставшееся сомнение или проверяет последующие изменения.
После нескольких исправлений полезен проход на вычитание: какие добавления все еще оправданы задачей? Каждое удаление взвешивай по нужному поведению и стоимости поддержки. Ценность прохода измеряй тем, насколько проще понять результат и действовать по нему, а не числом удаленных строк. Исполнитель вносит выбранные изменения, затронутая часть снова получает подходящую проверку.
Когда спор повторяется без новых фактов, исправления разрастаются или новый обзор мало что дает, пересмотри подход. Разбор несходимости находится в договоре триажа.
Как партнер видит работу
В долгой работе периодически давай короткую сводку, даже если партнер отошел: что уже выяснено, кто чем занят, чего ждешь и что проверишь дальше. Сообщай о существенных отклонениях, смене подхода и неожиданном росте затрат по мере их обнаружения. Если нового результата пока нет, назови состояние и основание продолжать ожидание. По сводке должно быть понятно, нужно ли вмешательство; обычное обновление позволяет продолжать работу без ответа партнера.
Если продолжение требует изменения цели, расширения границ, принятия существенного остаточного риска или заметных дополнительных затрат за пределами согласованного, останови зависимую работу и вынеси партнеру конкретный выбор. Объясни, что произошло, варианты, их последствия и свою рекомендацию. Пока решения нет, продолжай полезную независимую работу в прежних границах. Уже полученное разрешение сохраняет силу; технические действия внутри него организуй самостоятельно.
В конце вместе с результатом и основаниями приемки кратко оцени, как прошла работа по скиллу: кому что поручал, где переиспользовал контекст, что дали ревью и триаж, что потребовало переделок и где подход пришлось изменить. Назови основные источники расхода контекста и времени, отделяя затраты координатора от работы агентов. Числа приводи по доступным измерениям с их охватом; без них описывай наблюдаемые источники затрат и явно отмечай оценки. Покажи, что оказалось полезным, где были лишние затраты и какие ограничения остались. Глубину отчета выбирай по масштабу работы; для короткого прогона достаточно нескольких предложений.
Если прогон дал новое существенное наблюдение или ты дорабатываешь скилл по опыту работы, обратись к эмпирике и правилам ее хранения.