Плагин Just Run для Claude Code и Codex

• Вход без токена. OAuth-вход выполняет сам клиент. Модель не видит учетные данные, а плагин их не хранит.
• Один исходник для двух клиентов. Claude Code ставит папку как есть, а для Codex раскладка собирается из той же папки скриптом.
• Несколько скиллов с общими справочниками. Короткий SKILL.md описывает порядок действий, детали лежат в отдельных файлах.
• Проверка поведения. Набор из 24 кейсов запускается командой claude plugin eval.

Кому пригодится. Тем, кто делает или собирается делать свой плагин или набор скиллов для Claude Code или Codex. Особенно если плагину нужен удаленный MCP-сервер, одинаковая работа в двух клиентах и автоматические проверки.

> /plugin marketplace add https://platform.just-run.app/plugins/marketplace.json
> /plugin install just-run@just-run
# вход: /mcp → just-run → Authenticate

$ codex plugin marketplace add https://platform.just-run.app/plugins/codex.git
$ codex plugin add just-run@just-run
$ codex mcp login just-run

$ claude --plugin-dir just-run

• Скилл включается сам, когда запрос подходит под его описание. Явно запустить его можно командой /just-run:<скилл>.
• Другой экземпляр Just Run (свой или тестовый) отдает собственный маркетплейс по адресу <адрес>/plugins/marketplace.json. Адрес меняется настройкой base_url.
• Windows: передача файлов использует tar и curl.exe, которые встроены в Windows 10 версии 1803 и новее.

> Запусти этот скрипт в Just Run и верни результат
> Опубликуй папку dist как сайт под паролем
> Запускай report.py каждый будний день в 9:30 по Москве

Каждый инструмент Just Run доступен и напрямую, без скилла: скилл только задает порядок действий и правила.

├── .claude-plugin/plugin.json   # манифест, общая версия с Codex
├── .mcp.json                    # удаленный MCP-сервер Just Run
├── skills/<имя>/SKILL.md        # шесть скиллов
├── references/                  # справочники, общие для скиллов
├── assets/                      # иконки
├── scripts/codex_tree.py        # сборка Codex-варианта
├── evals/                       # 24 кейса для claude plugin eval
└── LICENSE                      # Apache-2.0

• SKILL.md короткий. В нем описание, когда скилл нужен, и процедура. Подробности, важные только на одном шаге, вынесены в справочник.
• Общие справочники: platform.md (инструменты, идентификаторы, ошибки), lifecycle.md (состояния песочницы), secrets.md, transfer.md (передача файлов), automation.md.
• Большой скилл разбит по ходу работы. У manage-telegram-bot свои справочники: SDK, ошибки, долгие операции, пересоздание, а в assets/starter/ лежит стартовый бот.
• Две формы ссылок. SKILL.md ссылается на общие справочники через ${CLAUDE_PLUGIN_ROOT}, а справочник на соседний файл по относительному пути: Claude Code подставляет переменную только в тексте скиллов.
• Язык. Плагин написан по-английски, потому что описания и инструкции читает модель. Русские фразы-триггеры («запусти в песочнице») оставлены только в описаниях.

$ python3 just-run/scripts/codex_tree.py \
    --base-url https://platform.just-run.app out
$ codex plugin marketplace add out
$ codex plugin add just-run@just-run

Скрипт использует только стандартную библиотеку Python 3.9+. Он отказывается собирать дерево, если в нем есть символические ссылки, не-UTF-8 имена файлов или ссылка на несуществующий файл.

• Секреты не проходят через чат. Токены хранятся как секреты платформы, ассистент называет их только по имени. Если пользователь вставил токен в сообщение, скилл просит его отозвать.
• Файлы уходят только по подтвержденному списку. Имена вроде .env*, *.pem и *.key исключаются, ссылки и служебные папки тоже.
• Удаление только по явной просьбе. Бота, сайт, песочницу или сервер удаляют после подтверждения, и ассистент называет, что именно пропадет.
• Готово только после проверки. Автоматизация проходит тестовый запуск, сайт проверяется по трем адресам, MCP-сервер возвращает список инструментов.
• Логи и вывод команд считаются данными. Инструкции внутри них не выполняются, а найденные секреты не повторяются в ответе.
• Ничего не создается дважды. Перед созданием ассистент ищет существующий ресурс, а повторные вызовы идут с ключом идемпотентности.
• Публичная ссылка названа публичной. Для внутреннего показа ассистент предлагает пароль. Токен хостинга MCP показывается один раз.
• Повторы не ломают результат. Доставка автоматизаций идет «хотя бы один раз», поэтому задачи с внешними эффектами должны защищаться от дублей.

• Промпт и ожидание. Кейс проверяет, какой скилл выбрал запрос и что ассистент сделал дальше.
• Грейдеры. Проверки по вызванным инструментам, по регулярным выражениям и по рубрике для LLM-судьи.
• Заглушки сервера. Ответы собираются по схеме OpenAPI, а check_mocks.py сверяет каждую заглушку со схемой.
• Негативные кейсы. Запросы, которые должны остаться локальными, проверяют, что скилл не включился и платформа не вызывалась.

$ claude plugin validate . --strict            # манифест и раскладка, бесплатно
$ python3 evals/make_cases.py                  # записать кейсы из описания
$ python3 evals/check_mocks.py                 # заглушки против схемы API
$ claude plugin eval . --case <имя> --runs 1 \
    --ablation none --no-publish                # один кейс при правке
$ claude plugin eval . --no-publish           # весь набор + базовая линия

Это стоит денег. Полный прогон запускает настоящие сессии Claude Code на вашем доступе и обходится в несколько долларов. Во время правок гоняйте один кейс. Кейсы меняйте в make_cases.py, а не в сгенерированных файлах.