Скилл для агентов и llms.txt
Интеграцию можно поручить своему LLM-агенту (Claude Code и другим, кто читает формат
SKILL.md): скилл astrum-partner-api даёт ему правила, контракт, шаблоны Python и Node
и проверку astrum_check.py. Своего контракта в скилле нет — он собран из этого гайда и
спецификации.
Установка
Версия 1.0.2, три команды:
curl -sO https://api.astrum.shop/v1/skill/astrum-partner-api-1.0.2.zip
curl -s https://api.astrum.shop/v1/skill/astrum-partner-api-1.0.2.zip.sha256 | shasum -a 256 -c -
unzip -q astrum-partner-api-*.zip -d .claude/skills/
sha256 с того же хоста проверяет целостность архива, а не его подлинность: архив и
сумма приходят с одного сервера. …-latest.zip — всегда последняя версия; снятая
версия отвечает 410 со ссылкой на актуальную.
Абзац для AGENTS.md
Абзац для AGENTS.md или CLAUDE.md вашего проекта:
Интеграция с Astrum Shop — по скиллу astrum-partner-api. Сначала песочница: ключ
ask_test_… только из переменной ASTRUM_KEY, секрет вебхука — из ASTRUM_WEBHOOK_SECRET.
Боевой ключ в код, чат и логи не попадает. Готово, когда astrum_check.py webhook и
astrum_check.py sandbox — всё ok.
Задачи агенту
Задачи агенту: «подключи заказ подписок Astrum к нашему магазину на FastAPI», «добавь приёмник вебхуков Astrum в Express-сервис», «найди, почему наш приёмник отвергает подписанные вебхуки Astrum».
Самопроверка
Отчёт astrum_check.py — строка на проверку: ok или FAIL с причиной, в конце
итог; код выхода 0 — всё ok. webhook <адрес> шлёт на ваш приёмник подписанные
тестовые события: верная подпись и повтор того же id — 2xx; изменённое тело, старое
время, нет подписи, мусор в заголовке — 4xx, а не 5xx; ответ дольше
5 с — провал. sandbox проходит живой цикл песочницы:
/me, тестовые доллары, заказ, повтор с тем же ref, товар (в выводе скрыт), активация,
события. С боевым ключом ask_live_…, секретом whsec_live_… или чужой базой проверка
останавливается до первого запроса.
Без скиллов
Без скиллов: оглавление для агентов — https://api., гайд и
контракт одним файлом — https://api..