66 lines
2.8 KiB
Markdown
66 lines
2.8 KiB
Markdown
# Правила работы агента в проекте fission
|
|
|
|
## ГЛАВНОЕ ПРАВИЛО
|
|
|
|
**НЕ "СОВЕРШЕНСТВОВАТЬ" РАБОЧИЙ КОД БЕЗ ЯВНОГО УКАЗАНИЯ.**
|
|
|
|
---
|
|
|
|
## Файловая система и выполнение команд
|
|
|
|
### Маппинг путей
|
|
|
|
Локальная папка `~/remote_dev/` примонтирована через sshfs к `~/terra/` на ВМ `5.172.178.213`.
|
|
Это **одна и та же файловая система**:
|
|
|
|
| Локально (VS Code) | На ВМ |
|
|
|----------------------------------|-------------------------------|
|
|
| `/home/naeel/remote_dev/fission` | `/home/naeel/terra/fission` |
|
|
| `/home/naeel/remote_dev/sless` | `/home/naeel/terra/sless` |
|
|
| `/home/naeel/remote_dev/IoT` | `/home/naeel/terra/IoT` |
|
|
|
|
Любой файл, сохранённый локально через VS Code, **мгновенно виден на ВМ**. SCP не нужен.
|
|
|
|
### Что можно делать локально
|
|
|
|
- **Редактировать файлы** — через VS Code, replace_string_in_file, create_file и т.д. Изменения сразу на ВМ.
|
|
- **Читать файлы** — read_file, grep_search, file_search, semantic_search — всё разрешено.
|
|
|
|
### Что ЗАПРЕЩЕНО локально
|
|
|
|
**Все команды выполнять ИСКЛЮЧИТЕЛЬНО через SSH на ВМ:**
|
|
|
|
```bash
|
|
ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 'КОМАНДА'
|
|
```
|
|
|
|
**Причина:** локально может быть активен VPN, что вызывает сбои при выполнении сетевых команд, обращениях к кластеру, Docker и пр.
|
|
|
|
Запрещено запускать локально (без ssh):
|
|
- `go build`, `go test`, `go mod tidy`
|
|
- `docker build`, `docker push`
|
|
- `kubectl`, `helm`
|
|
- `terraform`
|
|
- `curl`, `wget` к кластерным сервисам
|
|
- `git push`, `git pull` (git операции — через ssh на ВМ)
|
|
- Любые bash-скрипты проекта
|
|
|
|
### Формат работы
|
|
|
|
1. Отредактировать файлы локально (VS Code / инструменты агента)
|
|
2. Запустить команды через SSH на ВМ
|
|
3. Ждать результата
|
|
|
|
---
|
|
|
|
## Документация
|
|
|
|
Всё важное фиксировать в `doc/`:
|
|
- `doc/thinking/` — лог рассуждений агента (обязательно)
|
|
- `doc/progress.md` — трекер задач
|
|
- Обновлять после каждого значимого изменения.
|
|
|
|
## Git
|
|
|
|
Коммитить и пушить после каждого завершённого этапа.
|