Шаблоны промптов

Шаблон — это промпт с плейсхолдерами, каталогом и правами агента. Его запускают с текстом, файлами и фото — из интерфейса своим ключом, по секретной ссылке без входа или одним POST-запросом. Типичный случай — «загрузил видео, получил улучшенное»: промпт зовёт скилл, скилл кладёт результат в каталог прогона, страница отдаёт его на скачивание.

Экран «Шаблоны» открывается значком на главной и в боковой панели приложения.

Из чего состоит

• Промпт с плейсхолдерами. {{prompt}} — текст человека, {{files}} — пути присланных файлов, {{in}} и {{out}} — каталоги прогона. Любое другое {{имя}} становится полем формы запуска со своей подписью и значением по умолчанию.
• Каталог, модель, режим прав и набор инструментов — с чем работает агент.
• Отвечать ли на вопросы модели самому. Включено — прогон не встаёт на вопросе, берётся первый (рекомендованный) вариант. Выключено — вопрос получает тот, кто запустил.

Каждый прогон — обычный чат Claude Code: он виден в списке чатов с пометкой «шаблон» или «по ссылке», и хозяин открывает его со всей лентой. Присланное лежит в in/, результат агент кладёт в out/ — оба внутри .clauder/templates/ каталога шаблона.

Кто что может

• Заводит и правит шаблоны хозяин (и ключ без ограничений): шаблон задаёт каталог и права агента.
• Запускает ключ, которому шаблон выдан, — в настройках ключа доступа отмечается, какие шаблоны ему видны. Промпта, каталога и прав гость не видит.
• Права прогона — строже из двух: шаблона и ключа, который его запустил или выдал ссылку.

Секретная ссылка

Вкладка «Ссылки» выдаёт ссылку на запуск без входа — на час, сутки, неделю, 30 дней или свой срок, но не дольше срока самого ключа. Тот, кому её дали, видит только форму запуска, свои сообщения, текст ответов и файлы из out/ — ни инструментов, ни путей машины. История запусков по ссылке общая и остаётся видна после срока; отозванная ссылка перестаёт отвечать сразу.

Вебхук

У каждой секретной ссылки есть второй вход — запуск одним POST-запросом, без формы. Для CI, мониторинга, своих скриптов. Кнопка «Вебхук» в списке ссылок показывает адрес и готовый curl; в Android — «Копировать вебхук».

curl -X POST "http://<машина>:<порт>/api/t/<токен>/hook?env=prod" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Собери отчёт по вчерашним логам"}'

• Текст — поле prompt (или text) в JSON. Нет его — модели уходит само тело запроса: событие от GitHub или мониторинга она разберёт сама.
• Поля шаблона — одноимёнными ключами тела, а если сервис не даёт настроить тело — параметрами адреса.
• Права, срок и отзыв — те же, что у ссылки, а прогон попадает в её историю.
• Не больше 30 запусков в час на ссылку — защита от петли «CI дёргает сам себя».

В ответ приходит 202 с номером прогона, адресом его статуса и страницей, где виден ход работы.