Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

discript-qa

Универсальный QA-плагин для Claude Code. Полноценный процесс тестирования приложений и сервисов с 10 специализированными агентами.

License Claude Code


Что это

Плагин превращает Claude Code в полноценную QA-команду:

  • 10 специализированных агентов — функциональное, регрессионное, performance, security, a11y тестирование и другое
  • Единый формат багов — все агенты выдают результаты в одном формате
  • Универсальность — работает с любым стеком (web, API, mobile), настраивается под проект через бриф
  • Выборочный запуск — не прогоняет всех скопом, ты выбираешь нужных для конкретной задачи
  • Встроенный workflow — от начала аудита до исправлений и повторной проверки

Установка

⚡ Способ 1: одной командой (рекомендуется)

Скопируй и выполни в терминале:

curl -fsSL https://raw.githubusercontent.com/ikobzar-git/discript-qa/main/install.sh | bash

Скрипт:

  1. Делает бэкап твоих настроек Claude Code
  2. Скачивает плагин
  3. Регистрирует его в ~/.claude/settings.json

После установки — закрой Cursor полностью (Cmd+Q) и открой заново.

🔧 Способ 2: через команды Claude Code

Если способ 1 не подходит, в Claude Code выполни:

/plugin marketplace add ikobzar-git/discript-qa
/plugin install discript-qa@discript-qa

Перезапусти Cursor (Cmd+Q).

🗑️ Удаление

curl -fsSL https://raw.githubusercontent.com/ikobzar-git/discript-qa/main/uninstall.sh | bash

🔄 Обновление

Если установлен через способ 1 — просто повтори команду установки. Если через /plugin install — обновится автоматически при старте Claude Code.

2. Первое использование

В папке тестируемого проекта:

/qa-start         # заполнить бриф проекта
/qa-plan standard # выбрать агентов
/qa-run           # запустить прогон
/qa-report        # получить сводный отчёт
/qa-fix           # исправить найденные баги
/qa-retest        # повторно проверить

Команды

Команда Назначение
/qa-start Заполнить бриф проекта (1 раз на проект)
/qa-plan Умная рекомендация по набору агентов
/qa-run Запустить выбранных агентов параллельно
/qa-report Сводный отчёт с приоритизацией
/qa-fix Исправить найденные баги
/qa-retest Проверить фиксы и поймать регрессии
/qa-reproduce Воспроизвести баг по описанию пользователя
/qa-help Справка по всем командам

Агенты

Аудит

  • qa-functional — проверка работоспособности заявленного функционала (happy path)
  • qa-regression — проверка, что ранее работавшее не сломалось
  • qa-consistency — поиск непоследовательностей UX во всём продукте
  • qa-edge-cases — граничные случаи, нестандартный ввод, редкие сценарии
  • qa-integration — стыки систем, API, webhook-и, внешние сервисы
  • qa-performance — Core Web Vitals, Lighthouse, скорость API
  • qa-accessibility — WCAG 2.1 AA, скрин-ридеры, клавиатурная навигация
  • qa-security — OWASP Top 10, уязвимости

Расследование

  • bug-reproducer — минимальный воспроизводимый сценарий по размытому описанию

Исправление

  • developer — фиксы найденных багов по приоритету

Пресеты

Для типовых задач:

Пресет Агенты Когда использовать
smoke functional + edge-cases После мелких правок
standard functional + consistency + edge-cases + a11y Обычный аудит
deep Все, кроме security Перед важным релизом
release Все 10 Перед прод-релизом
security security + integration Security-аудит
performance performance + a11y Оптимизация метрик
regression regression + functional После крупных изменений
bug-hunt reproducer + functional + edge-cases Жалоба от пользователя

Использование:

/qa-run smoke
/qa-run release

Структура файлов проекта

После /qa-start в тестируемом проекте создаётся:

<проект>/
├── QA_BRIEF.md              # бриф проекта (заполняется 1 раз)
└── .qa/
    ├── bugs/                # карточки багов по агентам
    ├── screenshots/         # evidence
    ├── reports/             # сводные отчёты и планы прогонов
    ├── regression-registry.json
    └── fixtures/            # тестовые данные

Единый формат бага

Все агенты выдают находки в одинаковом формате:

### [Название]
- **Серьёзность:** БЛОКЕР | КРИТИЧНО | ВАЖНО | МЕЛКИЙ
- **Категория:** функционал | UX | a11y | performance | security | ...
- **Компонент:** (страница/модуль)

**Шаги воспроизведения:**
1. ...

**Ожидаемое / Фактическое:**
...

**Рекомендация:**
...

Полный шаблон: templates/BUG_REPORT.md


Workflow

┌─────────────────┐
│  /qa-start      │ ← заполняем бриф (1 раз)
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  /qa-plan       │ ← выбираем агентов
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  /qa-run        │ ← параллельный прогон агентов
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  /qa-report     │ ← сводный отчёт
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  /qa-fix        │ ← исправление
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  /qa-retest     │ ← повторная проверка
└────────┬────────┘
         │
         ▼
   0 БЛОКЕРОВ
   0 КРИТИЧНЫХ
         │
         ▼
      ✅ релиз

Правило 2 итераций: максимум 2 полных цикла аудит→фикс→retest. Если после 2-го остались блокеры — сигнал о более глубокой проблеме, требующей обсуждения.


Требования

  • Claude Code (любая актуальная версия)
  • Для live-тестирования: Playwright MCP (опционально, но рекомендуется)
  • Для a11y: axe-core (подтягивается через Playwright)
  • Для performance: Lighthouse CLI (опционально)

Если инструменты недоступны — агенты работают в режиме статического анализа кода.


Настройка под свой стек

В QA_BRIEF.md можно переопределить инструменты:

## 7. Инструменты тестирования
- E2E-браузер: Cypress
- A11y: WAVE
- Performance: WebPageTest
- API: Postman CLI (newman)

Агенты адаптируются под указанные инструменты.


Лицензия

MIT — LICENSE


Поддержка

  • Вопросы и предложения: создай issue в репозитории
  • Внутри Discript: пиши в рабочий чат

Как делиться с командой

Отправь в чат команде:

Установка discript-qa: выполни в терминале

curl -fsSL https://raw.githubusercontent.com/ikobzar-git/discript-qa/main/install.sh | bash

Потом закрой Cursor через Cmd+Q, открой заново, набери в Claude Code /qa-help — готово.

После установки команда работает с плагином так:

  1. В каждом проекте, где нужен QA, один раз делают /qa-start — заполняют QA_BRIEF.md.
  2. Дальше — /qa-plan standard/qa-run/qa-report/qa-fix/qa-retest.
  3. Обновления плагина — повторный запуск install.sh или автоматически при рестарте Cursor.

Контрибуция

Плагин живой — если находишь, что улучшить:

  • новые чек-листы для специфических доменов
  • новые агенты для редких задач
  • улучшения промптов существующих агентов

Создавай PR в репозиторий.

About

Universal QA plugin for Claude Code: 10 specialized agents for full testing process

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages