2.6 KiB

Raw Blame History

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 и приватные ключи.
Не выполнять деструктивные команды без подтверждения.
Не добавлять зависимости без необходимости.