MMCPMarkets
VR

vlad-ryzhkov/ai-qa-workshop-feb19

Developer tools
26 stars Quality 42 Trend 32
Repository Install

AI-промпты, агенты и анти-паттерны для QA — от аудита спецификаций до генерации API-тестов

Overview

Контекст развивается в английской версии репозитория: English version of this repository 🎤 Представлено на "Podlodka AI Crew #2" в феврале 2026 — видео / слайды Готовая коллекция AI-промптов, агентов и анти-паттернов для QA-процессов: от анализа спецификаций до генерации API-тестов. Структурированные промпты дают стабильный результат — каждый скилл в репозитории это проверенный .md-файл, который точно говорит AI что делать, что проверять и как форматировать вывод. Создан для воркшопа, работает как самостоятельный инструментарий (требует адаптации под ваш проект). Disclaimer: Результаты работы AI — даже с хорошими промптами — обязательно нужно проверять. 👇 Полная матрица совместимости — нажми для раскрытия 👇 🟢 нативно — 🟡 через ссылку на файл — 🔴 не поддерживается Инструменты, отличные от Claude Code, могут потреблять больше токенов — проверяй расход для каждого скилла.

README

AI for QA — Воркшоп

[!NOTE] Контекст развивается в английской версии репозитория: English version of this repository

🎤 Представлено на “Podlodka AI Crew #2” в феврале 2026 — видео / слайды

Готовая коллекция AI-промптов, агентов и анти-паттернов для QA-процессов: от анализа спецификаций до генерации API-тестов.

Структурированные промпты дают стабильный результат — каждый скилл в репозитории это проверенный .md-файл, который точно говорит AI что делать, что проверять и как форматировать вывод. Создан для воркшопа, работает как самостоятельный инструментарий (требует адаптации под ваш проект).

Disclaimer: Результаты работы AI — даже с хорошими промптами — обязательно нужно проверять.

🚀 С чего начать

1. Выбери инструмент

Инструмент Метод настройки Загрузка контекста
🟣 Claude Code Нативно Автоматически: CLAUDE.md → qa_agent.md → SKILL.md
🟢 OpenCode Нативно Автоматически: CLAUDE.md → qa_agent.md → SKILL.md
⚪️ Cursor MDC Rules через .cursor/rules/*.mdc
🔵 GitHub Copilot Custom Instructions через .github/copilot-instructions.md
🟤 Codex Agent Skills через AGENTS.md + .agents/skills/

2. Установка

  • Для Claude Code / OpenCode: Скопируй папку .claude/ из этого репозитория в корень своего проекта. Затем запусти /init-project в AI-чате для автоматической генерации CLAUDE.md.
  • Для других IDE: Смотри матрицу совместимости выше.

3. Запусти первый аудит

Открой AI-чат и следуй пайплайну QA Workflow Скиллы ниже.

📖 Подробные промпты для каждого IDE: docs/workshop-commands.md

🏗️ Скиллы настройки

Генерация и поддержка AI-конфигурационных файлов.

Скилл Что генерирует Когда использовать
/init-project CLAUDE.md — инструкции AI на уровне проекта Новый QA-проект без AI-конфига
/init-agent qa_agent.md — роль и принципы QA-агента Настройка поведения AI-агента
/init-skill SKILL.md — новый скилл с чеклистом и фазами Автоматизация повторяемой QA-задачи

🔬 QA Workflow Скиллы

Основной пайплайн — выбери точку входа по масштабу задачи:

[Macro] /repo-scout (весь репо)   ──┐
                                    ↓
[Micro] /spec-audit (одна спека)  ──→  audit/spec-audit_{date}.md
                                    ↓
         /test-cases               ──→  docs/test-cases/test-scenarios.md
                                    ↓
         /api-tests                ──→  src/test/kotlin/...Tests.kt
Скилл Вход Выход Что получишь
/repo-scout Бэкенд-репозиторий Карта API, инфраструктура, покрытие тестами Каталог эндпоинтов, пробелы, точки входа
/spec-audit API-спецификация QA-отчёт: пробелы, противоречия, OWASP ~15 дефектов, вопросы к PO, матрица рисков
/test-cases Спека + аудит Матрица тестовых сценариев (Markdown) Таблица: ~50–80 тест-кейсов на спеку
/api-tests Тест-сценарии + спека Production-ready тесты на Kotlin (JUnit 5, Allure) Kotlin-класс, готов к запуску: ./gradlew test

🧰 Другие скиллы

Скилл Назначение
/screenshot-analyze Анализ мобильных скриншотов на UI и L10N дефекты (переводы, CLDR, RTL)
/doc-lint Аудит качества документации — структура, дубликаты, нарушения SSOT
/skill-audit Аудит SKILL.md-файлов на раздутость, дублирование и вредные паттерны
/output-review Независимый аудит результата любого скилла по его чеклисту
/update-ai-setup Синхронизация реестра AI-сетапа после добавления или удаления скиллов

🏛️ Паттерны проекта

  • Progressive Disclosure — CLAUDE.md → qa_agent.md → SKILL.md загружаются только по требованию, экономят токены
  • Gardener Protocol — AI предлагает улучшения базы знаний по завершении каждого запуска
  • Quality Gates — 20+ файлов с анти-паттернами, против которых проверяется генерируемый код
  • Meta Configuration — скиллы /init-* сами генерируют и поддерживают конфигурационные файлы
  • Token Management — специализированные агенты (Auditor, SDET) и жёсткие лимиты контекста предотвращают раздувание окна

Подробный разбор подходов и файлов: docs/ai-setup.md

⚙️ Tech Stack (для генерируемых тестов)

Компонент Технология
Язык Kotlin
Test Framework JUnit 5
HTTP Client common-test-libs ApiClient
Serialization Jackson (SNAKE_CASE)
Assertions JUnit 5 + Hamcrest (checkAll)
Polling Awaitility
Reporting Allure

📄 Материалы воркшопа

📚 Полезные ресурсы

🧠 Prompt Engineering

🟣 Anthropic (Claude)

🔵 VS Code & GitHub Copilot

🔵 Cursor

🔵 Codex

🧠 Вайбкодинг

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add vlad-ryzhkov/ai-qa-workshop-feb19