verify-maestro — скилл для Claude Code: что делает и как установить
Скилл verify-maestro проверяет правки в репозитории Maestro в изолированном окружении: ставит сборку во временный HOME, прогоняет сценарии CLI и сохраняет лог для отчёта.
MIT ★ 238 обновлён 2026-10-17
npx skills add ReinaMacCredy/maestro --skill verify-maestro -a claude-codeЧто делает verify-maestro
Скилл запускает скрипт scripts/journey.sh <checkout>, разворачивая изолированный каталог /tmp/maestro-verify.XXXX с собственной домашней папкой и пустым репозиторием Git. Установка выполняется через bun <checkout>/bin/maestro.ts install под чистым окружением env -i, поэтому системные директории ~/.maestro и ~/.local/bin остаются нетронутыми.
Внутри окружения утилита проверяет диагностику через maestro doctor и имитирует действия пользователя: вызов каталога рецептов, проверку плейбуков, права сессий, блокировки политик и повторную инсталляцию. Без переменных MAESTRO_SESSION_ID и MAESTRO_SESSION_PID каждый вызов считается отдельной анонимной сессией, из-за чего шаг work done падает с ошибкой LEASE_HELD.
По завершении временная директория стирается. Полный стенографический отчёт с кодами возврата [exit N] сохраняется в путь топика journey-<n>.txt как подтверждение успешной проверки.
Какие задачи решает
- протестировать правки в CLI Maestro без изменения личных конфигов в
~/.maestro - проверить вывод
maestro doctorи состояние шимов в чистом окружении - прогнать пользовательские сценарии и зафиксировать коды возврата в лог
Примеры запросов агенту
- Запусти верификацию Maestro для текущей ветки через scripts/journey.sh
- Проверь статус maestro doctor во временном каталоге и покажи лог journey
- Прогони сценарии проверки Maestro и выведи коды завершения команд
Как установить verify-maestro
1Через Skills CLI (Vercel)
npx skills add ReinaMacCredy/maestro --skill verify-maestro -a claude-code2Вручную: положить файлы
~/.claude/skills/verify-maestro/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/verify-maestro/
1Через Skills CLI (Vercel)
npx skills add ReinaMacCredy/maestro --skill verify-maestro -a codex2Вручную: положить файлы
.agents/skills/verify-maestro/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ReinaMacCredy/maestro --skill verify-maestro -a cursor2Вручную: положить файлы
.cursor/skills/verify-maestro/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ReinaMacCredy/maestro .agents/skills/verify-maestro2Вручную: положить файлы
.github/skills/verify-maestro/SKILL.md1Через Skills CLI (Vercel)
npx skills add ReinaMacCredy/maestro --skill verify-maestro -a gemini-cli2Командой платформы
gemini skills install https://github.com/ReinaMacCredy/maestro --path .agents/skills/verify-maestroВручную: положить файлы
.devin/skills/verify-maestro/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о verify-maestro
Как установить verify-maestro в Claude Code?
Выполните команду npx skills add ReinaMacCredy/maestro --skill verify-maestro -a claude-code.
Зачем нужен verify-maestro?
Он воспроизводит полный путь пользователя в чистом окружении с изолированной переменной HOME, чтобы подтвердить работоспособность изменений до релиза.
Что нужно для выполнения сценариев проверки?
В системе должен быть установлен рантайм bun, а скрипт scripts/journey.sh запускается с фиксацией сессионных переменных MAESTRO_SESSION_ID и MAESTRO_SESSION_PID.
Исходный текст
SKILL.md · MIT
--- name: verify-maestro description: Verify a change in the maestro repository on the running product - install the checkout into a scratch HOME, doctor it, drive the CLI the way a user does, and capture the transcript as proof. Use before claiming a maestro change reached the installed, live, or journey layer. --- # verify-maestro Built from `maestro recipe show verification-skill`. Proves a change on an installed runtime without touching the owner's `~/.maestro` or `~/.local/bin`. ## Launch `scripts/journey.sh <checkout>` creates `/tmp/maestro-verify.XXXX` with its own `home/` and an empty git repo, then runs `bun <checkout>/bin/maestro.ts install` under `env -i` with that HOME and a PATH of the scratch shim dir, bun, and `/usr/bin:/bin`. `MAESTRO_SESSION_ID`/`MAESTRO_SESSION_PID` are pinned so every call is one session; without them each call is a new anonymous session and `work done` fails with `LEASE_HELD`. ## Doctor `maestro version` must print the checkout's commit, and `maestro doctor` must report `healthy`, `source: ok <checkout>`, and the shim pointing into the scratch HOME. A missing seat token and unverified Codex hooks are expected in the scratch HOME. ## Drive Add one block to `scripts/journey.sh` per journey the change touches, invoking `maestro` exactly as a user types it. The script already drives: - recipe catalog: `recipe list` shows the recipe, `recipe show` prints it. - playbooks: 25 playbook and method recipes listed, bug-fix's steps shown, the retired `work` recipe refused; `~/maestro/PRINCIPLES.md` has 24 sections; nine skills; the ten new agent renders; no PreToolUse hook. - brief and grant: the SessionStart `method:` line routes by playbook; the `delivery grant:` line appears only while `policy-auto-pr` is enabled. - bundle check: a fresh bundle's U1 skeleton is reported and exits 1. - a policy gate: `plugin enable`, `work add|start|done` blocked, then passing. - reinstall: a second install keeps the repository's policy choices. ## Capture Run `scripts/journey.sh <checkout> > "$(maestro topic path verify-maestro)/journey-<n>.txt"`. Each step prints its command output and `[exit N]`; read the exit codes, not only the text. Cite the transcript path and the checkout commit in the proof, tagged `(journey)`. ## Clean up The script removes its scratch root last. The transcript in the topic folder is the proof and stays. ## Feature map | Feature | Journey | Observable outcome | |---|---|---| | install / update / uninstall | install, reinstall | doctor healthy; `.maestro/config` keeps enables | | doctor, version | doctor | commit and source match the checkout | | recipe | recipe catalog, playbooks | new recipe listed and shown; playbooks listed, `work` refused | | PRINCIPLES.md, skills list, profiles, Claude hooks | playbooks | 24 sections, nine skills, ten renders, no PreToolUse | | brief, policy-auto-pr | brief and grant | `method:` line; grant line only while enabled | | plugin + policy gates | policy gate | blocked then passing `work done` | | work lifecycle (add, start, note, done, show) | policy gate (partial) | `w1 done` | | ready, status, trace, search | GAP | | | bundle check | bundle check | U1 skeleton reported, exit 1 | | bundle open/close, handoff | GAP | | | decision, decide, term, lesson | GAP | | | dispatch, handback | GAP | | | memory, room, owner (Hub) | GAP | | | topic, prompt, hook, brief, attention | GAP | | | team, slp (Herdr panes) | GAP: needs a live herdr room | | | graph, mcp | GAP | |
© ReinaMacCredy · MIT · ReinaMacCredy/maestro