self-hosted-release-validation — скилл для Claude Code: смоук-тесты
Скилл self-hosted-release-validation для Claude Code проверяет селф-хостед релизы через чистый сценарий Docker Compose. Оценивает сохранение данных в SQLite и готовность сборки к публичной бете.
Apache-2.0 ★ 104 обновлён 2026-11-17
npx skills add dodo-labs-ai/mem-forge --skill self-hosted-release-validation -a claude-codeЧто делает self-hosted-release-validation
Скилл запускает валидацию селф-хостед релиза по пути нового пользователя. Проверка идёт в изолированном проекте Docker Compose с портами только на loopback, запуском Admin UI и API, настройкой первой модели, синхронизацией источников, извлечением памяти и вызовом локального MCP.
Основной прогон выполняет скрипт scripts/compose_smoke.sh. Для шагов генерации и эмбеддингов скрипт принимает флаг --ollama, ключ OPENROUTER_API_KEY либо явные параметры --generation-provider и --embedding-provider. В релизном контуре скрипт запускается с флагом --quality рядом с provider_smoke.py, как предписывает docs/releasing-python-distribution.md.
Существующие тома MemForge, кэш плагинов и данные разработчика трогать запрещено: смоук-тест требует отдельного тома данных. Сохранность данных в SQLite доказывается перезапуском API или стека Compose на том же томе. Итогом проверки становится консервативный вердикт GO, CONDITIONAL GO или NO-GO.
Какие задачи решает
- проверить чистый запуск стека Docker Compose перед релизом
- подтвердить сохранность данных SQLite после перезапуска контейнеров
- составить матрицу поддержки источников данных вместо простого подсчёта
- вынести вердикт GO или NO-GO по публичной бете без подмены фикстурами
Примеры запросов агенту
- Проверь релиз селф-хостеда через scripts/compose_smoke.sh с отдельным Compose project
- Запусти смоук-тест Docker Compose с флагом --quality и ключом OPENROUTER_API_KEY
- Проверь персистентность SQLite после перезапуска стека и выдай вердикт по бете
Как установить self-hosted-release-validation
1Через Skills CLI (Vercel)
npx skills add dodo-labs-ai/mem-forge --skill self-hosted-release-validation -a claude-code2Вручную: положить файлы
~/.claude/skills/self-hosted-release-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/self-hosted-release-validation/
1Через Skills CLI (Vercel)
npx skills add dodo-labs-ai/mem-forge --skill self-hosted-release-validation -a codex2Вручную: положить файлы
.agents/skills/self-hosted-release-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dodo-labs-ai/mem-forge --skill self-hosted-release-validation -a cursor2Вручную: положить файлы
.cursor/skills/self-hosted-release-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dodo-labs-ai/mem-forge .agents/skills/self-hosted-release-validation2Вручную: положить файлы
.github/skills/self-hosted-release-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add dodo-labs-ai/mem-forge --skill self-hosted-release-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/dodo-labs-ai/mem-forge --path .agents/skills/self-hosted-release-validationВручную: положить файлы
.devin/skills/self-hosted-release-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о self-hosted-release-validation
Как установить self-hosted-release-validation в Claude Code?
Выполните команду npx skills add dodo-labs-ai/mem-forge --skill self-hosted-release-validation -a claude-code. Файл навыка появится в ~/.claude/skills/self-hosted-release-validation/SKILL.md.
Что проверяет self-hosted-release-validation?
Скилл валидирует запуск стека Compose на локальных портах, старт интерфейса и API, персистентность SQLite, пути сбора данных демоном и локальный MCP.
Что нужно для работы self-hosted-release-validation?
Требуются Docker Compose, скрипт scripts/compose_smoke.sh, а также локальный Ollama либо переменная OPENROUTER_API_KEY для работы моделей генерации и эмбеддингов.
Исходный текст
SKILL.md · Apache-2.0
--- name: self-hosted-release-validation description: "Validate an OSS self-hosted release through the newcomer Docker Compose path: isolated Compose project, SQLite persistence, source support matrix, local-agent sources and a public-beta GO/NO-GO. Use for compose smoke tests, release validation and beta-readiness reviews." --- # OSS Self-Hosted Release Validation - Validate self-hosted releases through the documented newcomer path: a clean Docker Compose project, loopback-only ports unless explicitly testing exposure, the default SQLite-backed data volume, Admin UI/API startup, first-run model configuration, a representative source sync, memory retrieval, and the packaged local MCP path. - `scripts/compose_smoke.sh` runs this newcomer path in an isolated Compose project (add `--ollama`, export `OPENROUTER_API_KEY`, or name each model kind's provider with `--generation-provider` and `--embedding-provider` for the model, sync and retrieval steps) and prints a table for the PR or release notes. A release runs it with `--quality`, beside `provider_smoke.py`, as the release guide, `docs/releasing-python-distribution.md`, states. - Use an isolated Compose project and dedicated volume for smoke tests. Never reuse or delete a developer's existing MemForge volume, source data, plugin cache, or external service state merely to obtain a clean result. - Prove SQLite persistence by restarting the API or Compose stack against the same isolated data volume and rechecking sources, documents, memories, keyword/vector health, and MCP retrieval. - Treat source support as an execution matrix, not a registry count. For each registered source type, state whether server collection, local-agent collection, credentials, browser sessions, VPN/internal reachability, or an external provider is required. Classify each type as verified, unsupported by design, blocked by a missing prerequisite, or failed. - Exercise local-agent sources through the real server-issued job and daemon path. A direct package injection may diagnose the service boundary, but it does not prove that the documented daemon workflow works. - For public-beta readiness, separately assess newcomer reproducibility, first-run UX, error messages, documentation accuracy, default data/privacy boundaries, and obvious exposure or secret-handling footguns. Give a conservative `GO`, `CONDITIONAL GO`, or `NO-GO`, with the smallest required fixes or disclosure language. - Do not present fixture-backed LLM/provider behavior as production-provider validation. Record the fixture contract, then distinguish it from real connector credentials and model-provider coverage.
© dodo-labs-ai · Apache-2.0 · dodo-labs-ai/mem-forge