Skip to content

Latest commit

 

History

History
41 lines (28 loc) · 6.04 KB

AGENTS.md

File metadata and controls

41 lines (28 loc) · 6.04 KB

Работа с сабагентами

Эти правила действуют для всего рабочего пространства, включая storm-engine-android и corsairs-android.

Когда делегировать

Используй сабагентов, если выполнено хотя бы одно условие:

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

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

Выбор модели

Характер задачи Модель Reasoning
Сложная: архитектура, неоднозначная диагностика, глубокий анализ, сложная оптимизация Astra — gpt-6-astra high, medium или low по сложности конкретной подзадачи
Умеренная сложность: обычная разработка, ограниченный анализ, интеграция Sol 6.1 — gpt-6.1-sol high, medium или low по сложности конкретной подзадачи
Простая и объёмная: повторяющиеся изменения, массовые проверки или обработка по ясным правилам Luna — gpt-6-luna Обычно low; повышай при необходимости

Выбирай модель по сложности выделенной подзадачи, а не всего проекта. Объём сам по себе не означает сложность. Если обнаружилась сложность, с которой выбранная модель не справляется, передай накопленные факты более подходящей модели вместо повторения одинаковых попыток.

При явном выборе модели передавай только нужный контекст и используй fork_turns="none", как требует интерфейс запуска сабагентов. Указывай модель и reasoning явно. Прямое указание пользователя о модели имеет приоритет.

Постановка и интеграция

  • Задавай конкретный результат, границы ответственности, необходимые исходные данные и критерии проверки. Указывай разрешённые файлы и ограничения.
  • Разделяй владение изменяемыми файлами, устройствами и сборочными каталогами. Согласовывай пересечения; не запускай конфликтующие изменения или тесты одновременно.
  • Пока сабагент занят, основной агент выполняет независимую полезную работу. Не дублируй его задачу без необходимости.
  • Отчёт сабагента должен отделять выполненное и действительно проверенное от предположений, ограничений и блокеров.
  • Основной агент отвечает за проверку изменений, интеграцию и итоговую валидацию. Сообщение сабагента об успехе не заменяет проверки результата.
  • Независимую проверку интерфейса поручай отдельному агенту по скиллу corsairs-android-ui-review, передавая реальные скриншоты и свидетельства взаимодействий.

Границы проектов и рабочие отчёты

  • Все новые библиотеки, native/C/C++ код, математика, ввод, игровой рендерер и его шейдеры принадлежат репозиторию движка storm-engine-android.
  • Репозиторий приложения содержит Android-интерфейс, интерфейсные игровые скрипты и упаковку APK. Движок подключается только Git-подмодулем; исходники движка и сторонние native-библиотеки не копируются в приложение.
  • Собранные native-библиотеки и шейдеры APK берёт из закреплённой версии движка. Код и версии новых зависимостей ведутся в движке.
  • Сгенерированные аудиты, отчёты проверок, логи, evidence и рабочие заметки не коммить. Храни их локально в игнорируемых docs/ или local-testing/. В Git оставляй необходимые инструкции сборки и использования рядом с соответствующим кодом.