45 lines
2.6 KiB
Markdown
45 lines
2.6 KiB
Markdown
# AGENT.md — правила работы
|
||
|
||
## Ответы
|
||
|
||
- **Коротко и по делу.** Без вступлений, извинений и повторов.
|
||
- Сначала результат, потом минимальные пояснения.
|
||
- Язык — русский, если не попросили иначе.
|
||
- Не пересказывать очевидное; ссылаться на конкретные файлы.
|
||
- Нужны уточнения — задать 1–3 конкретных вопроса.
|
||
- Не выдумывать факты: проверить или спросить.
|
||
|
||
## Проект
|
||
|
||
- Корень: `D:\!Projects\MpakoImageAIbot`.
|
||
- Стек: Python 3.10+, python-telegram-bot 21+, httpx, aiosqlite, SQLite, Docker.
|
||
- Требования: `plan.md`. План работ: `checklist.md`; отмечать выполненные пункты.
|
||
- Следовать структуре, именованию и стилю существующего кода.
|
||
- Секреты — только в `.env`. Не логировать токены, не коммитить `.env`, `storage/`, `data/`.
|
||
|
||
## Git / Gitea
|
||
|
||
- Remote: `ssh://git@home:2222/mpakobecex/MpakoImageAIbot.git`
|
||
(алиас `home` → `192.168.31.158`).
|
||
- Основная ветка — `main`.
|
||
- Перед коммитом: `git diff`, тесты/линтер, если есть.
|
||
- Коммиты атомарные: `feat:`, `fix:`, `docs:`, `chore:`.
|
||
- Не делать force push и не переписывать историю.
|
||
- Push — после успешной проверки.
|
||
|
||
## Работа с кодом
|
||
|
||
- Сначала прочитать существующий код, затем менять.
|
||
- Изменения минимальные и точечные; без попутного рефакторинга.
|
||
- Не удалять и не перезаписывать пользовательские файлы без подтверждения.
|
||
- Сетевые вызовы — async, event loop не блокировать.
|
||
- Ошибки обрабатывать явно: понятное сообщение пользователю + лог.
|
||
- После изменений проверять запуск/тесты и сообщать результат.
|
||
- Не оставлять проект в нерабочем состоянии.
|
||
|
||
## Безопасность
|
||
|
||
- Не выводить содержимое `.env` и приватные ключи.
|
||
- Не выполнять деструктивные команды без подтверждения.
|
||
- Не добавлять зависимости без необходимости.
|