# qa-planning

Скилл qa-planning собирает QA-контракт по фиче: нумерованные Gherkin-сценарии для источников данных и приёмочные критерии для фронтенда. Пригодится до начала реализации.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 353 у репозитория
- Автор: WellApp-ai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/WellApp-ai/Well/tree/HEAD/cursor-rules/skills/qa-planning/SKILL.md
- Обновлён: 2026-10-28
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/qa-planning

## Что делает

Скилл пишет QA-контракт для фичи. Поведение бэкенда и источников данных превращается в нумерованные Gherkin-сценарии с тегом `@G#N`, ожидания по фронтенду — в приёмочные критерии `AC#N`. Эти ID потом указывают в поле Satisfies плана и сверяет скилл `qa-commit`.

Работа идёт по фазам. Сначала инвентаризация источников: runtime API, статика, собранная на билде, прямые запросы к базе, сторонние сервисы, middleware. Дальше матрица предусловий для эндпоинта — заголовки, параметры пути, фильтры, поля тела, — одно действие `When` на сценарий и блок `Then` с кодом ответа и полями. Отдельная таблица говорит, что покрывать для каждого HTTP-метода.

На выходе markdown-документ, а не запускаемые тесты. Поэтому номера `G#N` и `AC#N` окупаются, только когда `qa-commit` стоит в том же проекте. Пропускать фазу 0 тоже не стоит: если у нетривиальной фичи набралось меньше трёх источников данных, автор советует вернуться к её объёму.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add WellApp-ai/Well --skill qa-planning -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/qa-planning/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/qa-planning/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add WellApp-ai/Well --skill qa-planning -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/qa-planning/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add WellApp-ai/Well --skill qa-planning -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/qa-planning/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install WellApp-ai/Well cursor-rules/skills/qa-planning
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/qa-planning/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add WellApp-ai/Well --skill qa-planning -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/WellApp-ai/Well --path cursor-rules/skills/qa-planning
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/qa-planning/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add WellApp-ai/Well --skill qa-planning -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/WellApp-ai/Well/tree/HEAD/cursor-rules/skills/qa-planning/SKILL.md

## Когда брать
- разложить фичу на пронумерованные Gherkin-сценарии до первой строки кода
- найти источники данных, которые легко пропустить: статику со сборки, middleware
- зафиксировать коды ответов и поля для каждого эндпоинта
- отдать QA-команде список ожидаемого поведения со ссылками `G#N`
- связать план реализации с приёмочными критериями через поле `Satisfies`

## Примеры запросов агенту
- Составь QA-контракт для эндпоинта `/v1/connectors`: перечисли все источники данных и распиши сценарии `G#N`.
- Напиши приёмочные критерии `AC#N` для формы логина перед реализацией.
- Проверь покрытие `DELETE /v1/connectors/{id}`: нужны сценарии на успех, 404 и запрос без авторизации.

## Похожие
- [bdd-scenarios](https://affpapa.org/nevibecode/skills/bdd-scenarios.md) — скилл · 180 установок
- [playwright-bdd-gherkin-syntax](https://affpapa.org/nevibecode/skills/playwright-bdd-gherkin-syntax.md) — скилл · 180 установок
- [gherkin-style-testing-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/gherkin-style-testing-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория
- [add-cucumber-tests](https://affpapa.org/nevibecode/skills/add-cucumber-tests.md) — скилл · 1100 установок
- [distill](https://affpapa.org/nevibecode/skills/kirkchen-distill.md) — скилл · 533 установки
- [cucumber-skill](https://affpapa.org/nevibecode/skills/cucumber-skill.md) — скилл · 283 установки

Из того же набора: [wellapp-ai/well](https://affpapa.org/nevibecode/by/wellapp-ai/well.md) — 3 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
