Co-Authored-By: Codex <noreply@openai.com>
10 KiB
Правила для агента
Перед работой прочитай:
- docs/PRINCIPLES.md — основные принципы: что такое редактор, что в нём делается и куда уходит результат. При противоречии с планом главнее принципы.
- docs/STATUS.md — что сделано, что не проверено и что делать дальше. Обнови этот файл, когда закончишь шаг.
- 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для продолжения после ошибок подготовки; проверяй неизменность постоянных таблиц. - Секреты. Пароль БД хранится в пользовательском профиле; старый
.envgit игнорирует. Не печатай его и не коммить. - Стиль. Комментарии и сообщения коммитов на английском, в духе существующего кода: объясняют «почему», ссылаются на функции ядра или клиента. Подписи интерфейса на русском.
- Коммиты — небольшие, по одному шагу. В конце сообщения строка
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 не разберёт.