К основному содержанию
скилл CX Codex

verify-maestro — скилл для Claude Code: что делает и как установить

Скилл verify-maestro проверяет правки в репозитории Maestro в изолированном окружении: ставит сборку во временный HOME, прогоняет сценарии CLI и сохраняет лог для отчёта.

MIT ★ 238 обновлён 2026-10-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ReinaMacCredy/maestro --skill verify-maestro -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/verify-maestro/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/verify-maestro/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
maestro-e2e raphaelbarbosaqwerty Скилл maestro-e2e для написания и отладки E2E-тестов на Maestro: логины, регистрация, навигация, диалоги разрешений. Работает с iOS, Android, Flutter, React Native и вебом. CX Codex +1 543установок openspec-verify-change openspec Скилл openspec-verify-change сверяет написанный код со спецификациями, задачами и архитектурой OpenSpec перед архивацией изменения. Пригодится при финальной приёмке задач. CX Codex +1 4 000установок verify официальный anthropics Скилл verify для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который тестирует изменения в harness end-to-end без Docker. CX Codex +1 257установок verify-10x-cli przeprogramowani Скилл verify-10x-cli запускает сквозную проверку утилиты 10x CLI против локального мок-сервера и сохраняет логи, снапшоты файлов и снимки терминала. CX Codex +1 230установок verify-this cursor Скилл verify-this проверяет конкретное утверждение на локальных данных: снимает замеры до и после, сравнивает артефакты и выдаёт один вердикт. CX Codex +1 2 600установок gsd-verify-work open-gsd Скилл gsd-verify-work для Claude Code проводит приёмочное тестирование созданных функций в диалоге с пользователем. Запускает проверку по шагам и сохраняет отчёт в файл UAT. CX Codex +1 594установок

Из того же набора10

Весь набор →
maestro-questionnaire Скилл maestro-questionnaire превращает нерешённый вопрос в Markdown-опросник для человека, у которого есть нужные ответы. Подходит для сбора информации асинхронно или на встрече. CX Codex +1 ★ 238звёзд репо maestro-coach Скилл maestro-coach для Claude и Codex, который разбирает непонятный вопрос по шагам и объясняет концепт за решением на реальном коде вашего репозитория. CX Codex +1 ★ 238звёзд репо maestro-bundle Скилл maestro-bundle управляет жизненным циклом связок SPEC, NOTES и VERIFY в фреймворке Maestro и передаёт контекст между сессиями агентов. CX Codex +1 ★ 238звёзд репо maestro-verify Скилл maestro-verify сверяет проверки с критериями приёмки, фиксирует вердикт и помогает закрыть рабочий пакет. Нужен перед передачей результата или закрытием задачи. CX Codex +1 ★ 238звёзд репо maestro-design Скилл maestro-design для разрешения блокирующих вопросов перед началом разработки: выбор архитектуры, моделирование, прототипирование и фиксация решений. CX Codex +1 ★ 238звёзд репо maestro-graph Скилл maestro-graph для Claude Code и Codex, который проводит задачу по заранее написанному графу: спускает агентов на каждый узел, собирает их результаты и переходит к следующему шагу. CX Codex +1 ★ 238звёзд репо maestro-work Скилл maestro-work для Claude Code задаёт общий порядок работы плейбуков: бриф, правила для исполнителя и формат передачи результата. Он включается при делегировании задачи и ведении её записи в Maestro. CX Codex +1 ★ 238звёзд репо maestro-council Скилл maestro-council проводит совет по решению, которое дорого откатывать: изолированные участники, проверка общей посылки, перекрёстный допрос и один обязательный вердикт. CX Codex +1 ★ 238звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой