58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# Разработка
|
||
|
||
## Инструменты
|
||
|
||
- Для поиска используй `rg`.
|
||
- Для точечной навигации по Rust-коду можно использовать Serena.
|
||
- Для актуальной документации библиотек используй Context7, если это нужно для изменения.
|
||
|
||
## Cargo-команды
|
||
|
||
Агентам нельзя самостоятельно запускать:
|
||
|
||
```bash
|
||
cargo run
|
||
cargo build
|
||
cargo test
|
||
cargo check
|
||
```
|
||
|
||
Исключение: пользователь прямо попросил запустить конкретную cargo-команду.
|
||
|
||
В финальном ответе после изменения укажи, какие cargo-команды не запускались, и дай минимальную ручную проверку.
|
||
|
||
## Quality Gate
|
||
|
||
Если пользователь прямо попросил проверить, закоммитить или выполнить план с тестами, используй тот же набор проверок, что и CI:
|
||
|
||
```bash
|
||
cargo fmt -- --check
|
||
cargo check --all-targets --all-features
|
||
cargo clippy --all-targets --all-features -- -D warnings
|
||
cargo test --all-features
|
||
git diff --check
|
||
```
|
||
|
||
Перед коммитом не оставляй `*.snap.new` файлы.
|
||
|
||
## Scope
|
||
|
||
- Делай одну логическую правку за раз.
|
||
- Не смешивай feature work, рефакторинг и документацию без необходимости.
|
||
- Не откатывай чужие изменения в dirty worktree.
|
||
- Не используй destructive git-команды без явной просьбы.
|
||
|
||
## Ручная проверка
|
||
|
||
Формат после функциональной правки:
|
||
|
||
```text
|
||
Проверь:
|
||
1. Запусти ...
|
||
2. Открой ...
|
||
3. Выполни ...
|
||
4. Ожидаемый результат: ...
|
||
```
|
||
|
||
Для чисто документационных задач cargo-проверки не требуются.
|