Практические советы, как получить от Pastukhov Agent максимум пользы, ответы на частые вопросы и шаги для решения типичных проблем, когда что-то работает не так, как ожидалось.
Как просить ИИ — несколько советов
- Будьте конкретны — чем больше деталей, тем лучше модель поймёт задачу. Вместо «исправь кнопку» скажите: «кнопка отправки в форме обратной связи не проверяет адрес электронной почты — добавь проверку». Хороший запрос уже содержит половину ответа.
- Делите большие задачи на маленькие — вместо «сделай всё приложение» начинайте с одной функции за раз. Модель лучше всего работает с понятными, сфокусированными задачами.
- Используйте навыки — выбирайте подходящий навык для задачи через селектор навыков. Навык «code review» для одного и того же кода даст другой результат, чем навык «development»: каждый навык — это свои инструкции для модели.
- Итерируйте — если первый ответ не идеален, попросите доработать его, а не начинать заново. «Сделай заголовок крупнее и поменяй цвет на синий» — быстрее, чем заново описывать всё требование.
- Давайте контекст — упоминайте имена нужных файлов, функций или образцы кода, которым модель должна следовать. Например: «Обнови функцию formatDate в src/utils/date.ts, чтобы она понимала европейский формат даты».
Частые вопросы
Как подключить свой собственный проект?
Задайте свои переменные окружения (путь к проекту, адрес Git-репозитория, учётные данные) и перезапустите Pastukhov Agent. Подробности — в разделе Начало работы и в инструкциях по установке для Windows или Docker.
Можно ли использовать несколько моделей ИИ?
Да. Создайте несколько моделей в настройках — по одной на каждую модель ИИ и её API-ключ — и переключайтесь между ними через селектор моделей в области ввода сообщений.
Что будет, если модель ошибётся?
Модель видит ошибки сборок и может исправить их сама, если включено Автоисправление. Также вы можете просто сказать ей, что пошло не так, и попросить исправить: модель прочитает тексты ошибок из панели сборки и использует их как контекст для починки.
Можно ли переносить навыки между проектами?
Навыки хранятся в папке .claude/skills/ внутри проекта и сохраняются вместе с ним. Чтобы перенести навык в другой проект, скопируйте папку навыков, либо попросите модель создать похожие навыки на основе существующих как шаблонов. Подробности — в разделе Навыки.
Как сделать резервную копию данных?
Файлы проекта — в вашем Git-репозитории: делайте коммиты и отправляйте их на сервер регулярно. История чатов и настройки хранятся в локальной базе данных: сохраняйте копию файла базы данных, а для постоянной эксплуатации можно настроить внешнюю базу данных.
Насколько мои данные приватны?
Ваш код обрабатывается локально — в вашем собственном контейнере или экземпляре. В облако уходят только сообщения чата, которые вы отправляете поставщику ИИ (например, Anthropic или OpenAI). Данные аналитики остаются локальными, если вы сами не настроили их отправку в ClickHouse для единой отчётности.
Проблемы с подключением
ИИ не отвечает: проверьте, что ваш API-ключ действителен и на балансе у поставщика есть средства. Посмотрите ключ в конфигурации модели.
Не получается отправить или получить изменения Git: убедитесь, что учётные данные Git (логин, личный токен доступа) заданы в переменных окружения. Подробности — в разделе Git.
Контейнер не запускается: посмотрите журналы Docker на ошибки запуска. Обычные причины — неверные переменные окружения, занятый порт или отсутствующие файлы конфигурации.
Порт уже занят: другая программа использует порт, который нужен Pastukhov Agent. Измените порт в конфигурации или остановите конфликтующую программу.
Советы по скорости
- Большие проекты — агент умеет работать с большими кодовыми базами, но скорость зависит от ресурсов вашего контейнера. Для очень крупных проектов увеличьте память и процессорное время, выделенные контейнеру.
- Длинные разговоры — очень длинные сессии тратят больше токенов и могут замедляться. Начинайте новый чат, когда прежний контекст уже не нужен для текущей задачи.
- Скорость сборки — если полное окружение разработки не нужно, используйте компактный образ Docker — сборки и запуск будут быстрее.
- База данных — при большом числе чатов со временем PostgreSQL работает лучше, чем SQLite. Подумайте о переходе, если проект активно растёт.
Куда обратиться за помощью
Если советы выше не помогли, а проблему решить не удалось:
- Telegram — напишите
@maxedantдля личной поддержки (быстрее всего); - Электронная почта — отправьте письмо на
max@pastukhov.com; - FAQ — посмотрите страницу FAQ, там собраны ответы на частые вопросы.
Обычно отвечаем в течение 12 часов, включая выходные. В обращении опишите проблему, приложите тексты ошибок и шаги, которые приводят к проблеме, — так мы решим её быстрее.