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

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

Скилл flow-next-qa прогоняет готовое приложение по сценариям из спеки и фиксирует находки P0/P1/P2 с доказательствами из живого запуска. Завершается вердиктом ship: ДА или НЕТ.

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

Что делает flow-next-qa

Скилл берёт acceptance criteria спеки как сценарии, R-ID превращает в таблицу покрытия, а раздел границ — в список того, что тестировать не нужно. Приложение он ведёт через flow-next-drive, а если в проекте есть .flow/features/, использует эту навигацию для перехода между экранами.

Вердикт SHIP ставится только на основе доказательств из запущенного приложения — скриншотов, консоли, наблюдаемого состояния. Прочитать исходный код и написать PASS без запуска приложения скиллу прямо запрещено; если приложение недоступно или нет драйвера, результат — BLOCKED, а не проходной вердикт. Читать код для объяснения уже зафиксированного сбоя можно.

Запускается командой /flow-next:qa с идентификатором спеки или как необязательный этап pipeline.qa в flow --auto (по умолчанию отключён). Он дополняет CI, стейджинг и ручное QA, но не заменяет их и не правит код сам — только находит и передаёт находки дальше. Включать этап pipeline.qa стоит только там, где /flow-next:prime подтвердил готовность приложения к QA: засеянные данные, документированный вход для разработки, доступная для вождения поверхность.

Какие задачи решает

  • прогнать готовую фичу по сценариям из acceptance criteria
  • собрать находки P0/P1/P2 с доказательствами из живого приложения
  • получить вердикт ship: да или нет перед make-pr
  • проверить покрытие R-ID из спеки реальными сценариями
  • встроить пробный QA-прогон в автономный пайплайн flow --auto

Примеры запросов агенту

  • Запусти /flow-next:qa для спеки SPEC-042
  • Прогони QA по текущей фиче с /flow-next:qa и покажи вердикт
  • Включи этап pipeline.qa в flow --auto и запусти проверку через /flow-next:qa

Как установить flow-next-qa

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

Команда ставит плагин flow-next целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gmickel/flow-next --skill flow-next-qa -a claude-code

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

~/.claude/skills/flow-next-qa/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flow-next-qa

Как установить flow-next-qa в Claude Code?

Выполните /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next.

Что делает flow-next-qa?

Скилл запускает живое приложение, проверяет сценарии из спеки и фиксирует находки P0/P1/P2 с доказательствами, завершая работу вердиктом SHIP: да или нет.

Может ли flow-next-qa поставить PASS, просто прочитав код?

Нет, это прямо запрещено: вердикт держится только на доказательствах из запущенного приложения, а без доступного приложения или драйвера результат — BLOCKED.

Исходный текст

SKILL.md · MIT
---
name: flow-next-qa
description: Live-app real-user QA pass derived from the spec. Drives the running app via flow-next-drive, derives scenarios from the spec's AC / R-IDs / boundaries, files structured P0/P1/P2 findings with evidence, and ends with a YES/NO ship verdict receipt. Consumes `.flow/features/` navigation when present. Triggers on /flow-next:qa with a spec id. Runs user-invoked OR as the optional `pipeline.qa` stage of `flow --auto` (default off). Augments — never replaces — CI/staging/manual QA. FORBIDDEN from marking PASS by reading source — the verdict rests on captured evidence from the live app, never on agent narration.
user-invocable: false
allowed-tools: AskUserQuestion, Read, Bash, Grep, Glob, Write, Edit, Task
---

# /flow-next:qa — live-app real-user QA pass

Drive the running app the way an unforgiving real user would, with scenarios taken from the spec,
file P0/P1/P2 findings with captured evidence, and end with a YES/NO ship verdict written as a
`qa_verdict` receipt. The spec is the source of intent: acceptance criteria become scenarios,
R-IDs become the coverage table, boundaries say what not to test, decision context says what the
app should do.

QA is a cheap first live pass over the finished build. It does not replace CI, staging or manual
QA, and it does not fix product code: it files, surfaces and hands off. Findings are advisory; the
human reviewer and the land gate decide.

It runs when the user invokes it, or as the optional `pipeline.qa` stage (`off | on | auto`,
default `off`) that `/flow-next:flow` runs after all tasks are done and before make-pr. When
setting or reading that key, read [gate-selection.md](../flow-next-flow/references/gate-selection.md);
[`flowctl.md`](../../docs/flowctl.md) has the config row. Enable the stage only where
`/flow-next:prime` reports the app is QA-ready (seeded data, a documented dev login, a drivable
surface, readable runtime evidence); otherwise every run ends BLOCKED.

Read [working-rules.md](../../references/working-rules.md) first unless you already have this run; it holds for every step.

## The hard rule

**SHIP rests on evidence captured from the running app** (screenshots, console output, observed
state). A SHIP reached by reading the source or the diff, from narration, or from "the code looks
right" has broken this. With no reachable app or no driver, the outcome is BLOCKED, never a pass.
Reading source to explain a failure you already captured is fine.

## Preamble

flowctl is bundled, not on `PATH`. Define it once; later blocks here and in `workflow.md` use `$FLOWCTL`:

```bash
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
```

This skill runs inline on the host (not forked) so it can ask the user for undocumented facts.

## Arguments

The first non-flag token is the spec id. `--target <url>`, `--receipt <path>` and `--base <ref>`
take a value (as `--flag value` or `--flag=value`). `mode:autonomous` turns on autonomous mode.

```bash
SPEC_ID=""; PREV=""
# No positional parameters: the host rewrites them inside skill code blocks.
# Quote the pasted arguments once so a URL's `&` or `;` stays data.
RAW_ARGS="$ARGUMENTS"
for ARG in $RAW_ARGS; do
  case "$PREV" in
    --target)  QA_TARGET_URL="$ARG"; PREV=""; continue ;;
    --receipt) QA_RECEIPT_OVERRIDE="$ARG"; PREV=""; continue ;;
    --base)    QA_BASE_REF="$ARG"; PREV=""; continue ;;
  esac
  case "$ARG" in
    --target|--receipt|--base) PREV="$ARG" ;;
    --target=*)  QA_TARGET_URL="${ARG#--target=}" ;;
    --receipt=*) QA_RECEIPT_OVERRIDE="${ARG#--receipt=}" ;;
    --base=*)    QA_BASE_REF="${ARG#--base=}" ;;
    mode:autonomous) QA_AUTONOMOUS=1 ;;
    -*) echo "Unknown flag: $ARG (ignored)" >&2 ;;
    *)  [[ -z "$SPEC_ID" ]] && SPEC_ID="$ARG" ;;
  esac
done
[[ -n "$PREV" ]] && echo "Flag $PREV given without a value (ignored)" >&2
[[ "${FLOW_AUTONOMOUS:-}" == "1" ]] && QA_AUTONOMOUS=1
NO_PROMPT=0
[[ "${QA_AUTONOMOUS:-}" == "1" || "${AUTONOMOUS:-}" == "1" ]] && NO_PROMPT=1
export QA_TARGET_URL QA_RECEIPT_OVERRIDE QA_BASE_REF QA_AUTONOMOUS NO_PROMPT
```

**Autonomous mode** (`NO_PROMPT=1`; `flow --auto` dispatches with `mode:autonomous`) asks
nothing. Each fact the interactive run would ask for is resolved from the spec, config or
environment; when it cannot be, the run writes a BLOCKED receipt and exits cleanly. The one
exception is an unresolvable spec id, which is an error (non-zero exit, message on stderr).

Now follow [workflow.md](workflow.md): discover, derive, prepare, execute, file, verdict.

© Gordon Mickel · MIT · gmickel/flow-next

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

Все скиллы по теме «Тесты и QA» →
flow-checker uxuiprinciples Скилл flow-checker для Claude Code проверяет пользовательские сценарии до вёрстки и перед релизом. Чеклисты выявляют узкие места в онбординге, формах, тарифах и дашбордах. CX Codex +1 ★ 33звёзд репо ralph-wiggum fstandhartinger Скилл ralph-wiggum для Claude Code ведёт автономную разработку по спецификациям, перезапуская контекст на каждой итерации, чтобы агент сохранял нить долгой задачи. CX Codex +1 1 400установок tlc-spec-driven Felipe Rodrigues - github.com/felipfr Скилл tlc-spec-driven для Claude Code организует разработку фич через спецификацию, дизайн, задачи и исполнение. Работа идёт пошагово, с атомарными коммитами и проверкой требований тестами. CX Codex +1 1 300установок spec-driven-workflow Alireza Rezvani Скилл spec-driven-workflow для Claude Code, который требует написать спецификацию до первой строки кода: требования, критерии приёмки, границы задачи. Останавливает разработку, пока спека не одобрена человеком. CX Codex +1 600установок ns-spec-driven nextstage-brasil Скилл ns-spec-driven для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который ведёт доставку фичи по формальной спецификации. CX Codex +1 208установок agentic-skills akillness Скилл agentic-skills ведёт задачу через шесть фаз, от спеки до релиза, и не даёт писать код раньше зафиксированных требований. CX Codex +1 125установок

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

Весь набор →
workflow-scout Субагент workflow-scout находит настройки CI/CD, шаблоны задач и пулл-реквестов, ботов код-ревью и конфиги релизов перед подготовкой окружения. CX Codex ★ 730звёзд репо tooling-scout Субагент tooling-scout сканирует проект на наличие линтеров, форматтеров, type-checker'ов и хуков. Вызывается командой /flow-next:prime, напрямую не запускается. CX Codex ★ 730звёзд репо flow-next-resolve-pr Скилл flow-next-resolve-pr координирует разбор замечаний к pull request на GitHub, запускает субагентов для веток обсуждения и закрывает треды через GraphQL. CX Codex +1 ★ 730звёзд репо build-scout Субагент build-scout анализирует конфигурацию сборки, команды запуска, CI и выходные файлы проекта. Работает как часть /flow-next:prime, а не как отдельная команда. CX Codex ★ 730звёзд репо env-scout Субагент env-scout сканирует репозиторий на наличие шаблонов .env, Docker, скриптов сборки и документации. Работает внутри оркестратора flow-next. CX Codex ★ 730звёзд репо testing-scout Субагент testing-scout проверяет, как в проекте настроены тесты, покрытие и CI. Его запускает /flow-next:prime, а не разработчик напрямую. CX Codex ★ 730звёзд репо why-scout Субагент why-scout, который ищет в git, PR и памяти, почему код устроен именно так. Отвечает на вопросы о логике изменений с опорой на реальные артефакты. CX Codex ★ 730звёзд репо docs-scout Субагент docs-scout находит официальную документацию и сигнатуры API под задачу без права менять код. Пригодится перед началом разработки фичи. CX Codex ★ 730звёзд репо

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

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