Приложение В. Шаблоны промптов

Приложение В. Шаблоны промптов для частых задач

В этом приложении собраны готовые шаблоны промптов для самых распространённых задач. Вы можете скопировать любой шаблон, подставить свои данные (вместо текста в квадратных скобках [...]) и отправить агенту.

Как пользоваться шаблонами:

1. Скопируйте текст шаблона в диалог с агентом.
2. Замените все [значение] на свои реальные данные (названия, ссылки, пути и т.д.).
3. Убедитесь, что у вас настроены нужные плагины (например, для GitHub или сервера).
4. Отправьте промпт и дождитесь выполнения.

Важно: если задача требует доступа к GitHub или серверу, убедитесь, что вы уже настроили соответствующие плагины (см. Главы 4 и 5). Если используете расписание — установите dsh-automation (Глава 9).

Шаблон 1: Создание сайта-визитки с деплоем

Когда использовать: когда вам нужен простой одностраничный сайт с базовой информацией, который сразу загружается на сервер.

ЦЕЛЬ: Создать одностраничный сайт-визитку для компании «[название компании]».

Что должно быть на сайте:
- Логотип (заглушка — просто текст с названием компании)
- Блок «О нас» с текстом-заглушкой (примерно 3–4 предложения)
- Блок «Услуги» с [количество] пунктами (придумай сам, исходя из названия компании)
- Блок «Контакты»: телефон [номер], email [почта], адрес [адрес]
- Форма обратной связи (имя, телефон, сообщение) — без реальной отправки, просто заглушка

Дизайн: минималистичный, основной цвет [цвет, например #1a5276], шрифт [шрифт, например Roboto] из Google Fonts.

Технологии: HTML + CSS + JavaScript (всё в одном файле index.html).

РЕСУРСЫ:
- Репозиторий: [ссылка на ваш GitHub-репозиторий]
- Сервер: [имя сервера из настроек SSH]
- Папка на сервере: [путь на сервере, например /home/dsh-agent/www/название_проекта]

ШАГИ:
1. Склонируй репозиторий на локальный компьютер (или используй существующий).
2. Создай index.html с указанным дизайном и содержанием.
3. Открой index.html в браузере и проверь, что всё выглядит нормально.
4. Закоммить изменения с сообщением «feat: add landing page for [название компании]».
5. Запушь на GitHub.
6. Подключись к серверу [имя сервера] и скопируй файлы в папку [путь] (используй git pull или rsync).
7. Проверь, что сайт открывается по адресу [URL вашего сайта].

ОГРАНИЧЕНИЯ: Не используй фреймворки (React, Vue и т.д.) — только чистый HTML/CSS/JS. Не трогай другие файлы на сервере.

ОБРАБОТКА ОШИБОК: Если страница не открывается после деплоя, проверь права доступа к папке и попробуй перезапустить веб-сервер. Если не получится — сообщи мне текст ошибки и остановись.

ФИНАЛ: Пришли ссылку на GitHub-репозиторий и URL работающего сайта.

Шаблон 2: Парсинг данных с сайта (с расписанием)

Когда использовать: когда нужно регулярно собирать информацию с сайта (курсы валют, цены, новости) и отправлять результат в Telegram или по почте.

ЦЕЛЬ: Настроить автоматический сбор данных с сайта [URL сайта] и отправку отчёта в [Telegram / email].

РЕСУРСЫ:
- Используй плагин dsh-automation для расписания.
- Используй [Telegram-бот / email-сервис] для отправки уведомлений.

ШАГИ:
1. Напиши скрипт на Python, который:
   - Заходит на сайт [URL]
   - Извлекает следующие данные: [опишите, что именно парсить, например, курс USD/RUB, цены на товары, заголовки новостей]
   - Обрабатывает данные (например, вычисляет среднее, фильтрует)
   - Формирует результат в виде текста или таблицы
2. Сохрани скрипт в файл `[имя_скрипта].py` в рабочей папке.
3. Проверь скрипт локально (запусти и убедись, что он выдаёт корректные данные).
4. Настрой расписание: запускать скрипт [периодичность, например, каждый день в 10:00 по московскому времени].
5. Настрой отправку результата в [Telegram-канал / email] по адресу [адрес].

ОГРАНИЧЕНИЯ: Не используй Selenium — только requests и BeautifulSoup. Не храни токены в коде, используй переменные окружения. Не превышай [количество] запросов в минуту.

ОБРАБОТКА ОШИБОК: Если сайт недоступен, попробуй повторить через 5 минут до 3 раз. Если не получится — отправь мне сообщение об ошибке и остановись.

ФИНАЛ: Покажи мне лог первого выполнения, чтобы я убедился, что всё работает.

Шаблон 3: Обновление контента на сайте из источника

Когда использовать: когда контент сайта нужно обновлять по данным из внешнего источника (Google Sheets, CSV, API).

ЦЕЛЬ: Обновить контент на сайте [URL сайта] из источника [укажите источник: Google Sheets, CSV-файл, API].

РЕСУРСЫ:
- Сервер: [имя сервера]
- Источник данных: [ссылка на Google Sheets / путь к CSV / описание API]

ШАГИ:
1. Скачай новые данные из источника.
2. Обнови файлы на сервере [путь к файлам, которые нужно обновить].
3. Если используется кеш, перезапусти его.
4. Проверь, что сайт отображает обновлённые данные.

ОГРАНИЧЕНИЯ: Не изменяй структуру базы данных (если используется). Не удаляй существующие файлы, только перезаписывай.

ОБРАБОТКА ОШИБОК: Если источник недоступен, остановись и сообщи мне. Если при обновлении возникла ошибка, покажи её текст.

ФИНАЛ: Отправь уведомление в Telegram об успешном обновлении.

Шаблон 4: Автоматический сбор и отправка отчёта

Когда использовать: когда вам нужен регулярный отчёт (например, по продажам, посещаемости, маркетинговым метрикам), который собирается из нескольких источников и отправляется в удобном формате.

ЦЕЛЬ: Собрать данные из [перечислить источники: CRM, Google Analytics, база данных] и сформировать отчёт за [период: день, неделя, месяц].

РЕСУРСЫ:
- Используй плагин dsh-automation для расписания.
- Используй [Telegram / email] для отправки.

ШАГИ:
1. Напиши скрипт, который:
   - Подключается к [источник 1] и забирает данные [какие]
   - Подключается к [источник 2] и забирает данные [какие]
   - Объединяет их и вычисляет ключевые метрики: [список метрик]
   - Генерирует отчёт в формате [текст / таблица / PDF]
2. Сохрани скрипт в файл `[имя_скрипта].py`.
3. Проверь локально.
4. Настрой расписание: запускать [периодичность].
5. Настрой отправку отчёта в [Telegram / email] по адресу [адрес].

ОГРАНИЧЕНИЯ: Используй только безопасные API-ключи (переменные окружения). Не храни пароли в коде.

ОБРАБОТКА ОШИБОК: Если какой-то источник не отвечает, запиши ошибку в лог и продолжай с остальными. Если все источники недоступны — остановись и сообщи мне.

ФИНАЛ: Пришли мне пример отчёта после первого запуска, чтобы я проверил формат.

Шаблон 5: Работа с GitHub — создание репозитория, коммит, PR

Когда использовать: когда вам нужно автоматизировать работу с GitHub: создать новый репозиторий, сделать коммит с новым кодом, создать Pull Request и т.д.

ЦЕЛЬ: [Опишите, что нужно сделать: создать новый репозиторий и залить в него код / обновить существующий репозиторий и создать PR / создать Issue и т.д.]

РЕСУРСЫ:
- GitHub-аккаунт: [ваше имя пользователя]
- Репозиторий: [название или ссылка]

ШАГИ:
1. [Если нужно создать новый репозиторий]: создай новый публичный репозиторий с именем [название] и описанием [описание].
2. Склонируй репозиторий (или используй существующий).
3. [Напиши или обнови код] — здесь можно вставить часть про создание кода.
4. Закоммить изменения с сообщением «[сообщение коммита]».
5. Запушь в ветку [название ветки, например main или feature].
6. [Если нужно создать PR]: создай Pull Request из ветки [название] в ветку [целевая ветка].

ОГРАНИЧЕНИЯ: Не удаляй существующие файлы без моего разрешения. Не используй force push.

ОБРАБОТКА ОШИБОК: Если при пуше возникает конфликт, остановись и покажи мне конфликтующие файлы.

ФИНАЛ: Пришли ссылку на Pull Request (если создавался) или ссылку на репозиторий.

Шаблон 6: Создание простой интерактивной страницы / игры

Когда использовать: когда вам нужна небольшая игра или интерактивный элемент (например, для сайта или маркетинговой кампании).

ЦЕЛЬ: Создать [название игры/страницы] в одном HTML-файле.

Описание: [кратко опишите, что должно делать, например, игра «Сапёр», калькулятор, викторина, форма с анимацией].

Технологии: чистый HTML + CSS + JavaScript (всё в одном файле).

Дизайн: [опишите желаемый стиль, например, минималистичный, в стиле ретро, с основным цветом #...].

ШАГИ:
1. Создай файл `[имя_файла].html`.
2. Реализуй всю логику на чистом JavaScript внутри одного HTML-файла (без внешних библиотек).
3. Открой файл в браузере и проверь, что всё работает.
4. Если есть баги — исправь их.

ОГРАНИЧЕНИЯ: Не используй сторонние библиотеки (jQuery, React и т.д.) — только встроенные возможности браузера.

ОБРАБОТКА ОШИБОК: Если страница не открывается или не работает, проверь консоль браузера и исправь ошибки.

ФИНАЛ: Покажи мне готовый файл и скажи, работает ли страница.

Шаблон 7: Генерация контента для соцсетей (с плагином dsh-content-lab)

Когда использовать: когда вам нужен регулярный контент-план для Instagram, Telegram-канала или блога.

ЦЕЛЬ: Создать контент-план для [название социальной сети или блога] на [период: неделя, месяц].

Тема блога: [ваша тема, например, «здоровое питание», «цифровой маркетинг», «путешествия»].

РЕСУРСЫ:
- Используй плагин dsh-content-lab.

ШАГИ:
1. Сгенерируй [количество] тем для постов — используй инструмент `content_topic_generator`.
2. Для каждой темы сгенерируй [количество] вариантов заголовков (разных стилей: с цифрами, с вопросами, эмоциональные) — используй `content_title_rewriter`.
3. Выбери лучший вариант для каждого поста и напиши полноценный пост для [название соцсети] — используй `content_post_writer`.
4. Добавь хештеги — используй `content_hashtag_generator`.
5. Сформируй календарь публикаций с датами и временем — используй `content_calendar`.

ОГРАНИЧЕНИЯ: Посты должны быть на русском языке. Длина поста: [например, до 2000 символов]. Избегай кликбейта.

ОБРАБОТКА ОШИБОК: Если какой-то шаг не удаётся, сообщи мне и перейди к следующему.

ФИНАЛ: Покажи мне готовый контент-план в виде таблицы: день, тема, заголовок, текст поста, хештеги.

Шаблон 8: Безопасный промпт для проверки кода (read-only)

Когда использовать: когда вы хотите, чтобы агент только проанализировал код или проект, но ничего не менял. Это хороший способ проверить, что агент понимает структуру проекта, прежде чем давать ему изменяющие команды.

ЦЕЛЬ: Проанализировать проект в текущей рабочей папке. Не вносить никаких изменений.

Задача: [опишите, что нужно проанализировать: структуру проекта, найти потенциальные проблемы, оценить качество кода, найти неиспользуемые файлы и т.д.].

РЕСУРСЫ:
- Рабочая папка: [путь, или просто текущая]
- Никаких изменений в файлах не производить.

ШАГИ:
1. Изучи структуру папок и файлов.
2. [Конкретные шаги анализа, например, найди все файлы с расширением .js и проверь их на наличие ошибок].
3. Собери результаты в краткий отчёт.

ОГРАНИЧЕНИЯ: Категорически запрещено создавать, перезаписывать или удалять файлы. Запрещено выполнять команды, изменяющие состояние системы (установка пакетов, изменение конфигов). Запрещено отправлять какие-либо данные по сети без моего явного разрешения.

ОБРАБОТКА ОШИБОК: Если для анализа нужно запустить опасную команду, пропусти этот шаг и сообщи мне.

ФИНАЛ: Предоставь отчёт в виде структурированного текста с выводами и рекомендациями.

Шаблон: фича в существующем проекте (feature → push)

Когда использовать: после главы «Страховка» (вы уже в DSH со своими репо), когда в проекте есть AGENTS.md, а задача — обычное развитие (не «с нуля весь сервер»).

Прочитай AGENTS.md и plan.md в этом workspace. Работай только по ним.

ЦЕЛЬ: [одна конкретная правка / фича].
Критерий успеха: [что увидеть в браузере / какой URL / какое поведение].

ОГРАНИЧЕНИЯ:
- Только ветка feature/[имя] (или создай её от актуальной). В main не коммитить и не пушить.
- Не трогать .env и секреты. Не создавать SSH-ключи. Не подключаться к VPS сам.
- Не расширять scope. Не читать чужие /opt и чужие репозитории.
- Sandbox: только этот workspace.

ШАГИ:
1. Сделай минимальные правки под цель.
2. Кратко опиши diff.
3. git add + commit + push HTTPS в feature-ветку (не спрашивай разрешения).
4. Выдай готовый блок для VPS:
   cd /opt/[проект]
   git fetch origin && git checkout [ветка] && git pull
   docker compose up -d --build [сервис]
5. Чек-лист приёмки: ветка, URL проверки, что не должно быть в diff (секреты).

Если застрял — остановись, покажи Trajectory-ошибку и предложи узкий следующий шаг.

Шаблон: только команды для сервера выката (агент без SSH на тот хост)

Не подключайся к серверу. Не читай чужие каталоги.

Задача уже запушена в ветку [feature/... ] репозитория [имя].
Напиши владельцу точный блок команд для VPS (путь /opt/[проект], сервис Docker [имя])
и отдельный блок, если менялся Caddy-conf.
Плюс 3 пункта «как проверить, что выкатилось».

Как адаптировать шаблоны под свои нужды

1. Замените все [текст в квадратных скобках] на свои реальные данные.
2. Если какая-то часть не нужна, удалите её или закомментируйте.
3. Если нужно добавить дополнительные шаги, просто вставьте их в раздел «ШАГИ».
4. Если задача требует использования конкретных плагинов, укажите это в разделе «РЕСУРСЫ».
5. Для изменения уровня детализации — регулируйте текст в разделах «ОГРАНИЧЕНИЯ» и «ОБРАБОТКА ОШИБОК»: чем подробнее, тем лучше.

Совет: сохраните удачные промпты в репозитории (например docs/prompts/) — это часть страховки, если чат Cursor пропадёт.