release-qa — команда для Claude Code: QA перед релизом
Команда release-qa для Claude Code проверяет код перед выпуском: сравнивает его с последним тегом версии, запускает тесты и ручные проверки, пишет отчёт с вердиктом ship или fix-first. Блокирует /publish до прохождения проверок.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/release-qa.mdЧто делает release-qa
Команда release-qa проверяет готовность кода к выпуску за один проход. Она вычитывает diff с последнего тега v*, запускает автоматические ворота (тесты, линтеры), затем тратит время на ручные проверки тех путей, которые указаны в surface-map.yml. По итогам пишет отчёт в vault с вердиктом — если все чеки прошли, он говорит ship, иначе fix-first с перечнем FAIL. Этот отчёт обязателен: без него команды /publish* откажут при попытке залить тег.
Если после правок нужно перепроверить только сломанные чеки, вызови команду с аргументом recheck — она не будет повторять уже пройденные проверки, а переберёт только те, что были FAIL или BLOCKED. Все ворота повторяются в любом случае. Результаты и доказательства (скриншоты, логи) хранятся в локальной песочнице под $EVIDENCE_DIR — путь задаёт .claude/sandboxes-env.sh.
Какие задачи решает
- Определить, готов ли код к выпуску перед публикацией версии
- Проверить изменённые пути по чекlistу surface-map
- Собрать доказательства ручных проверок в один отчёт
- Заблокировать публикацию, если есть открытые FAIL
- Переопроверить только сломанные чеки после правок
Примеры запросов агенту
- Запусти полную проверку перед первым релизом:
/release-qa - После того как исправил ошибки, запусти только пересчёт сломанных чеков:
/release-qa recheck - Посмотри итоговый отчёт и вердикт в
Projects/speckit companion/QA Report <YYYY-MM-DD>.md
Как установить release-qa
Вручную: положить файлы
.claude/commands/release-qa.mdВызов — /release-qa. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/release-qa.mdВызов — /prompts:release-qa. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/release-qa.prompt.mdВручную: положить файлы
.gemini/commands/release-qa.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о release-qa
Как установить release-qa в Claude Code?
Скопируй файл .claude/commands/release-qa.md в свой проект. Команда автоматически подхватится при загрузке контекста проекта.
Что делает release-qa?
Проверяет код перед выпуском: сравнивает diff с последним тегом версии, прогоняет автоматические ворота (тесты, линтеры) и ручные проверки по карте путей, затем пишет отчёт с вердиктом ship или fix-first. Без вердикта ship и нулевых ошибок команды /publish* откажут при попытке залить тег.
Зачем нужен аргумент recheck?
После исправления ошибок recheck переберёт только те проверки, что были FAIL или BLOCKED в последнем отчёте, не повторяя уже пройденные, и напишет новый отчёт для текущей версии кода.
Исходный текст
release-qa.md · MIT
--- allowed-tools: Bash(git:*), Bash(npm:*), Bash(node:*), Bash(python3:*), Bash(code:*), Bash(specify:*), Bash(claude:*), Bash(awk:*), Bash(cp:*), Bash(mkdir:*), Bash(ls:*), Bash(date:*), Bash(open:*), Read, Write, Edit, Skill, TaskCreate, TaskUpdate description: Release-scoped QA of SpecKit Companion, run once after a batch of fixes. Scopes itself from the diff since the last v* tag, runs automated gates first, spends desktop time on what needs eyes, and writes one vault report with a ship / fix-first verdict. Gates /publish. argument-hint: "[recheck]" --- ## What this does QA for a release, once, at the end of a batch. It is issue-agnostic: it reads what is being released (the diff since the last `v*` tag and the `## [Unreleased]` sections of both changelogs), not a ticket list. It is step 3 of `/release-loop` (and `recheck` is step 6); every `/publish*` command refuses to tag without its report. ## Run Load the `release-qa` skill and follow it in order: Step 0 scope, Step 1 automated gates, Step 2 scripted and desktop checks, Step 3 report. The skill owns the flow, `.claude/skills/release-qa/surface-map.yml` owns which paths need which checks, and the helper scripts next to it do the mechanical work. `$ARGUMENTS`: - empty: the full run, baseline included. - `recheck`: after fixes. Repeats the automated gates and only the checks that ended FAIL or BLOCKED in the latest report, and writes a new report against the new HEAD. The result is one note, `Projects/speckit companion/QA Report <YYYY-MM-DD>.md` in the vault. Raw evidence stays in the sibling `speckit-sandboxes` checkout, under `$EVIDENCE_DIR/<date>-release-qa/` (and `$EVIDENCE_DIR/<date>-qa-<name>/` for what `qa-stage.sh` stages); `. .claude/sandboxes-env.sh` sets `$EVIDENCE_DIR`. ## Release gate The publish commands run this before they tag. The gate passes only when all three hold: 1. The newest `Projects/speckit companion/QA Report*.md` in `~/dev/GitHub/obsidian-vault` exists. 2. Its `head` frontmatter equals `git rev-parse --short HEAD`, or every commit in `git log <head>..HEAD --format=%s` is a release commit (`chore: bump version to …`, or `chore(speckit-ext): release …`, `chore(claude-mod): release …` or `chore(canvas): release …`). Anything else means the report is for other code. 3. It says `verdict: ship` and `fails: 0`. When it does not pass, stop and say why in one line: no report, a report for another sha (name both), or the open FAIL checks. The fix is `/release-qa` (or `/release-qa recheck` after fixes). Only an explicit instruction in the conversation to skip QA for this release overrides the gate. Say `QA gate overridden` in the release report. ## Guardrails - QA never edits the repo, files issues, or fixes anything. Every FAIL is a fix candidate in the report, and the next batch picks it up. - Never run it per ticket, and never on a dirty tree. - Nothing is repeated: a check runs once however many surfaces ask for it, and a screenshot is shot once and reused as evidence and as a docs candidate. - A changed path with no surface in the map is reported as `no QA mapping`, never given a guessed check.
© alfredoperez · MIT · alfredoperez/speckit-companion