| name | init-agent |
| description | Генерирует qa_agent.md — должностную инструкцию для AI с культурой QA-команды, принципами и anti-patterns. Используй при настройке AI под проект, онбординге новых AI-агентов или стандартизации подходов к тестированию. Не используй для редактирования существующего qa_agent.md — правь вручную. |
| allowed-tools | Read Write Edit Glob Grep |
| agent | agents/auditor.md |
| context | fork |
/init-agent — Генератор qa_agent.md
Создание "должностной инструкции" для AI: mindset, anti-patterns, quality gates.
Фокус: QA-инженеры широкого профиля (API, UI, Mobile, Performance).
Перед началом
Прочитай .claude/qa_agent.md.
Когда использовать
- Настройка AI под культуру конкретной QA-команды
- Стандартизация подходов к тестированию
- Онбординг новых AI-агентов в проект
Алгоритм выполнения
Verbosity Protocol
Structured Output Priority: Весь analysis идёт в артефакт (MD/HTML), не в чат.
Chat output (ограничения):
- Brief Summary: max 5 строк (что нашли, сколько, итог)
- Findings table: max 15 строк (топ по severity)
- Полный отчёт:
📊 Полный отчёт: {path} + открыть файл
Iterative steps: Не выводить прогресс по каждому файлу. Checkpoint только при:
- Phase transition (Фаза N → Фаза N+1)
- Blocker обнаружен
- Завершение (SKILL COMPLETE)
Tools first:
- Grep → table → report, без "Now I will grep..."
- Read → analyze → report, без "The file shows..."
Post-Check: Inline перед SKILL COMPLETE (5-7 строк checklist), не отдельный файл.
Шаг 1: Определи профиль QA
Спроси пользователя или определи по проекту:
Какой тип тестирования преобладает?
1. API Testing — REST/GraphQL, контрактное тестирование
2. UI/E2E Testing — Web (Playwright/Selenium), Mobile (Appium)
3. Performance Testing — нагрузочное, стресс-тестирование
4. Security Testing — OWASP, пентест
5. Mixed — комбинация нескольких типов
Обработка ошибок Шага 1
references/qa-profiles.md не найден → Используй встроенные принципы из секции "Шаг 4: Quality Gates" и перейди к Шагу 4 напрямую.
Профиль неоднозначен (пользователь ответил размыто) → Уточни одним вопросом:
Назови 1-2 типа задач, которые занимают > 70% времени команды:
REST API тесты / UI автоматизация / Нагрузочное / Пентест
qa_agent.md уже существует → Предупреди: "Файл существует. Перезаписать? (да / нет)". Не перезаписывай без подтверждения.
Шаг 2: Выбери Core Principles
Прочитай references/qa-profiles.md и выбери принципы по профилю из Шага 1:
- Всегда включай Универсальные принципы (5 принципов)
- Добавь принципы для конкретного профиля (API/UI/Performance/Security)
- Для Mixed профиля — объедини принципы всех релевантных категорий
Шаг 3: Собери Anti-Patterns
Из references/qa-profiles.md выбери релевантные анти-паттерны:
- Всегда включай Универсальные Anti-Patterns (8 записей)
- Добавь специфичные для профиля (если применимо)
- Сформируй единую таблицу для секции "Anti-Patterns (BANNED)"
Шаг 4: Определи Quality Gates
## Quality Gates
### Перед коммитом
- [ ] Код компилируется без ошибок
- [ ] Тесты проходят локально
- [ ] Нет хардкода (ID, email, телефоны)
- [ ] Cleanup работает
### Перед PR
- [ ] Тесты изолированы (можно запустить в любом порядке)
- [ ] Naming convention соблюдён
- [ ] Нет закомментированного кода
- [ ] Покрытие критичных сценариев
### Перед релизом
- [ ] Все тесты зелёные в CI
- [ ] Нет flaky тестов
- [ ] Performance baseline не деградировал
Шаг 5: Генерация qa_agent.md
# QA Agent: [Профиль]
## Core Mindset
[3-5 принципов из Шага 2]
## Anti-Patterns (BANNED)
[Таблица из Шага 3]
## Quality Gates
[Чек-листы из Шага 4]
## Test Design
### Структура теста (AAA)
```[язык]
// Arrange — подготовка
// Act — действие
// Assert — проверка
Naming Convention
`[actor] can [action] when [condition]`
`[actor] cannot [action] when [condition]`
Data Management
Генерация уникальных данных
[Пример для выбранного языка]
Cleanup Pattern
[Пример try-finally для выбранного языка]
Cross-Skill Protocol
/spec-audit → проверь требования/testcases → напиши тест-кейсы/api-tests → автоматизируй
Не прыгай сразу к коду!
## Вывод
Сохрани в `.claude/qa_agent.md`
## Пример диалога
User: /init-agent
AI: Какой профиль QA-инженера?
- API Testing
- UI/E2E Testing
- Performance Testing
- Security Testing
- Mixed (универсальный)
User: 5
AI: Генерирую qa_agent.md для универсального QA...
[Показывает файл с принципами из всех категорий]
Сохранить в .claude/qa_agent.md? (y/n)
## Self-Check (перед сохранением)
- [ ] **Core Principles:** 3-5 принципов выбраны и заполнены?
- [ ] **Anti-Patterns:** Таблица содержит минимум 5 записей?
- [ ] **Quality Gates:** Все 3 секции (коммит/PR/релиз) присутствуют?
- [ ] **No placeholders:** Нет оставшихся `[xxx]` в тексте?
- [ ] **Cross-Skill Protocol:** Секция присутствует с `/spec-audit` → `/testcases` → `/api-tests`?
## Связанные файлы
- Шаблон: `.claude/skills/init-agent/references/qa-agent-template.md`
- Профили QA: `.claude/skills/init-agent/references/qa-profiles.md`
- Полный гайд: `docs/ai-files-handbook.md`
