Files
2026-11-14 18:42:51 +04:00

10 KiB
Raw Permalink Blame History

Правила для агента

Перед работой прочитай:

  1. docs/PRINCIPLES.md — основные принципы: что такое редактор, что в нём делается и куда уходит результат. При противоречии с планом главнее принципы.
  2. docs/STATUS.md — что сделано, что не проверено и что делать дальше. Обнови этот файл, когда закончишь шаг.
  3. docs/ROADMAP.md — обязательная таблица моделей и правила автоматической передачи задач.

Автоматический выбор модели

Правило владельца от 2026-11-14 действует на всех этапах ROADMAP.

Работа Модель Reasoning effort Профиль
Оркестрация, архитектура, контракты и итоговая приёмка gpt-6-astra high mw_astra_high
Код, Rust/SQL, скрипты, тесты, конфигурация и отладка gpt-6.1-terra high mw_terra_high
Поиск файлов, исходников и документации, UI-свидетельства gpt-6-luna high mw_luna_high
Независимое ревью изменений Terra и проверок gpt-6.1-sol high mw_sol_high

Astra определяет контракт и назначает только нужные роли: Luna ищет, Terra реализует, Sol независимо проверяет значимые изменения кода, Astra принимает. Для экономии токенов передавай узкие задания со свежим контекстом (fork_turns="none"), не запускай все роли на каждое малое действие и не повторяй поиск или проверки без новой причины. Полные правила — в ROADMAP § 6.1.

Для написания, ревью, отладки и рефакторинга кода применяй andrej-karpathy-skill: уточняй значимые предположения, сохраняй минимальный объём правок и проверяй результат. Источник закреплён на c2771d3ad0fd46f71d06fd9853cd6b0ad987737f.

  • Передавай исполнителю цель, разрешённые файлы, состояние, критерии готовности, необходимые документы и проверки; назначай model, reasoning_effort, fork_turns="none".
  • Назначенный исполнитель не повторяет маршрутизацию. Один файл одновременно меняет один исполнитель. Если модель или подагенты недоступны, сообщи ограничение и доступный вариант.
  • Telegram-уведомление отправляет только координатор после завершения общей задачи. Делегирование не меняет разрешения на БД, коммиты и публикацию.

Поиск по проекту через Graphify

Для поиска файлов, символов и связей сначала используй существующий локальный граф кода. Если индекса нет или код изменился после его построения, выполни update.

./scripts/graphify.ps1 update
./scripts/graphify.ps1 query "quest" --seed crates/editor-app/src/quest_ui.rs --budget 1200
./scripts/graphify.ps1 vocab
./scripts/graphify.ps1 explain "crates/editor-app/src/quest_ui.rs"

Установка и точные команды описаны в docs/graphify.md. Luna выбирает до 12 терминов из реального словаря графа, сообщает их и выполняет запрос. Русские формулировки сопоставляет с существующими именами символов. Проверяй source_file/source_location в найденном исходнике. Граф отражает AST-структуру поддерживаемого кода. Смысл документации и runtime-поведение проверяй чтением и запуском. Для точного текста используй rg и чтение найденных файлов. После правок кода обнови индекс. Каталог graphify-out/ локальный, игнорируется Git. Секреты и сборки не индексируются. Hooks и фоновые процессы не нужны.

Сборка и проверки

cargo fmt --all
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

Перед коммитом все три команды должны пройти. Проверяй результат каждой: &&-цепочка с grep проглатывает код выхода.

Проверка окна без мыши

Окно можно проверить по логу и снимку кадра. Переменные окружения:

Переменная Что делает
EDITOR_SHOT=<png> Сохраняет кадр и закрывает окно. Перед этим пишет в лог строку EDITOR_SHOT … с положением камеры, точкой под центром экрана и состоянием превью.
EDITOR_SHOT_AT=<сек> Когда снимать (по умолчанию 25; миру нужно время подгрузиться).
EDITOR_SHOT_DIST=<ярды> Расстояние камеры до точки --at под 45° (по умолчанию 25).
EDITOR_SHOT_VIEW=x,y,z;tx,ty,tz Фиксированное положение камеры и точка взгляда в координатах WoW для воспроизведения кадра. При EDITOR_SHOT пользовательский ввод не двигает диагностическую камеру.
EDITOR_SHOT_SWEEP=1 Плавное вращение диагностической камеры вокруг точки взгляда для проверки согласованности геометрии.
EDITOR_PROBES=x,y,z;… Луч вниз с высоты +3 ярда над каждой точкой. Пишет в лог EDITOR_PROBE … hit_z dz.
EDITOR_SHOT_SEARCH=<текст> Запрос в каталоге.
EDITOR_SHOT_SELECT=<guid> Выбранный спавн.
EDITOR_SHOT_DIALOG=export|quit Окно открывается с вопросом об экспорте или о несохранённых изменениях.

Пример: EDITOR_SHOT=shot.png EDITOR_SHOT_DIST=8 cargo run -p editor-app -- p.json --at -8935,-129.5,84. Снимок открывается инструментом чтения изображений.

Правила

  • Benilla закреплён. Переход на новый коммит Benilla — отдельный коммит: обновить BENILLA_REV, собрать, прогнать проверки и замеры на WMO (Крепость Штормграда -8439.98,329.392,122.579, Башня магов -9010.78,876.575,148.702). Не правь ../benilla: это чужой рабочий репозиторий. API Benilla не стабилен (../benilla/docs/CONTRIBUTING.md).
  • Ядро vMaNGOS (/home/sindo/core, WSL) — репозиторий владельца, рабочая ветка development. Не коммить туда без явной просьбы. Тестовые миграции убирай из sql/content/migrations, тестовые строки — из локальной БД.
  • Локальная БД. Контейнер можно запускать: wsl -e bash -lc 'cd /home/sindo/core/deploy/local && ./compose.sh up -d db'. Записывать в неё можно только миграциями и только в тестах, за которыми ты потом убираешь. Для изоляции SQL-теста используй явный DDL временных таблиц: MariaDB может отклонить CREATE TEMPORARY TABLE name LIKE schema.name при совпадении имён. Не используй --force для продолжения после ошибок подготовки; проверяй неизменность постоянных таблиц.
  • Секреты. Пароль БД хранится в пользовательском профиле; старый .env git игнорирует. Не печатай его и не коммить.
  • Стиль. Комментарии и сообщения коммитов на английском, в духе существующего кода: объясняют «почему», ссылаются на функции ядра или клиента. Подписи интерфейса на русском.
  • Коммиты — небольшие, по одному шагу. В конце сообщения строка Co-Authored-By: с именем агента.

Особенности окружения (Windows + Git Bash + WSL)

  • Git Bash переписывает аргументы вида /home/... в wsl. Перед такими вызовами ставь MSYS_NO_PATHCONV=1.
  • Пути к Windows-файлам для .exe пиши как C:/..., не /c/....
  • В heredoc через инструмент Bash обратные слэши могут схлопнуться. Пути с \\wsl.localhost пиши через файл или инструмент редактирования.
  • В .env пути с обратными слэшами заключай в одинарные кавычки, иначе dotenvy не разберёт.