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

release-qa — команда для Claude Code: QA перед релизом

Команда release-qa для Claude Code проверяет код перед выпуском: сравнивает его с последним тегом версии, запускает тесты и ручные проверки, пишет отчёт с вердиктом ship или fix-first. Блокирует /publish до прохождения проверок.

MIT ★ 110 обновлён 2026-10-19

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/release-qa.md
Открыть на GitHub

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

Вопросы о 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

Похожие слэш-команды

Все слэш-команды по теме «Тесты и QA» →
running-release-tests aws Скилл running-release-tests запускает UI- и API-тесты релиза в AWS DevOps Agent по готовому тест-профилю. Пригодится перед выкаткой, когда нужно проверить сценарии и регрессии. CX Codex +1 1 600установок release-checklist Donchitos Скилл release-checklist формирует чеклист готовности релиза игры с учётом платформы, открытых багов из QA и требований сертификации вроде Steam или консолей. CX Codex +1 672установок release Devin-AXIS Команда release для запуска полного цикла выпуска iPolloWork: от проверки чистоты репозитория до публикации пакетов. Автоматизирует версионирование, теги и deploy через GitHub Actions. CX Codex +1 ★ 7 523звёзд репо team-release Donchitos Скилл team-release для Claude Code, Codex, Cursor и других платформ: запускает команду из релиз-менеджера, QA-лида, DevOps-инженера и продюсера для выпуска версии от кандидата до деплоя. CX Codex +1 650установок run-release alirezarezvani Команда run-release для Claude Code запускает workflow релиза по семантическому тегу версии. Автоматизирует создание аннотированного тега, черновика релиза и запрашивает одобрение перед публикацией. CX Codex +1 ★ 907звёзд репо release-guard hoangsonww Скилл release-guard прогоняет проверки готовности к релизу: сверяет команды в документации с package.json, смотрит, не разошлось ли описание архитектуры с кодом. CX Codex +1 ★ 1 198звёзд репо

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

Весь набор →
speckit.companion.living-show Команда speckit.companion.living-show для Claude Code показывает часть living spec: заголовки требований, одно требование целиком или правила для файла. Она запускается, когда нужно найти конкретное правило, не открывая весь документ. CX Codex +1 ★ 110звёзд репо speckit.companion.status Команда speckit.companion.status для Claude Code и Codex показывает шаг, статус, решения и следующее действие активной спеки из .spec-context.json. Она работает только на чтение. CX Codex +1 ★ 110звёзд репо speckit.plan Промпт speckit.plan запускает процесс планирования реализации по спецификации: собирает research.md, data-model.md и схемы API в папку contracts/. CX Codex GP ChatGPT ★ 110звёзд репо sandbox Команда sandbox создаёт временный SpecKit-проект по рецепту или показывает доступные рецепты и уже созданные песочницы. Работает в Claude Code и Codex. CX Codex +1 ★ 110звёзд репо install-local Команда install-local собирает и ставит локальные версии расширений VS Code и spec-kit из репозитория speckit-companion, автоматически повышая patch-версию для сброса кэша. CX Codex +1 ★ 110звёзд репо speckit.companion.living-drift Команда speckit.companion.living-drift показывает, какие файлы возможностей living spec изменились с момента последнего коммита их спецификаций. Помогает найти изменения, которые не попали обратно в спецификацию. CX Codex +1 ★ 110звёзд репо speckit.companion.resume Команда speckit.companion.resume для Claude Code восстанавливает состояние spec-driven разработки после перерыва. Она переносит записанные решения в контекст и запускает следующий шаг пайплайна. CX Codex +1 ★ 110звёзд репо speckit.git.commit Команда speckit.git.commit для Claude Code добавляет изменения в индекс Git и создаёт коммит после команд Spec Kit по настройкам конфигурации проекта. CX Codex +1 ★ 110звёзд репо

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

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