setup · fcakyon, qa — скилл для Claude Code: что делает и как установить
Скилл setup для Claude Code разворачивает интеграционные тесты и пользовательские сценарии тестирования в проекте. Включается при запросах настроить сквозное тестирование или добавить QA-сценарии.
Apache-2.0 ★ 1 216 обновлён 2026-11-16
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install qa@claude-settingsЧто делает setup
Скилл разворачивает инфраструктуру сквозного тестирования для веб-сайтов, браузерных расширений, бэкендов, приложений под Android и нативных программ под macOS. На этапе поиска утилита project-qa discover анализирует маршруты, манифесты и команды существующих тестов, выявляя области покрытия.
Затем команда project-qa setup генерирует конфигурацию .agents/qa/config.json, файл прогона .agents/qa/suite.mjs и локальное руководство .agents/skills/qa/SKILL.md. Созданные заготовки сценариев заменяются на реальные пользовательские цепочки без моков сетевого транспорта, а существующие файлы конфигурации при этом сохраняются.
Для работы требуются Node.js и скрипты раннера из каталога плагина. Для тестов нативных приложений macOS обязателен отдельный прогон Swift-тестов в CI на macOS, а графические проверки интерфейса требуют анализа реальных скриншотов перед подтверждением приёмки.
Какие задачи решает
- настроить каркас сквозного QA-тестирования в проекте
- сгенерировать конфигурацию
.agents/qa/config.jsonи файл тестовsuite.mjs - обнаружить непротестированные маршруты и зависимости через
project-qa discover - интегрировать проверки нативных приложений macOS в CI
Примеры запросов агенту
- Настрой сквозное QA-тестирование для бэкенда и веб-интерфейса
- Создай интеграционные тесты для браузерного расширения
- Добавь сценарии проверки пользовательских путей в проект
Как установить setup
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install qa@claude-settingsКоманда ставит плагин qa целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a claude-code3Вручную: положить файлы
~/.claude/skills/setup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/setup/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a codex2Вручную: положить файлы
.agents/skills/setup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a cursor2Вручную: положить файлы
.cursor/skills/setup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install fcakyon/claude-codex-settings plugins/qa/skills/setup2Вручную: положить файлы
.github/skills/setup/SKILL.md1Через Skills CLI (Vercel)
npx skills add fcakyon/claude-codex-settings --skill setup -a gemini-cli2Командой платформы
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/qa/skills/setupВручную: положить файлы
.devin/skills/setup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о setup
Как установить setup в Claude Code?
Выполните /plugin marketplace add fcakyon/claude-codex-settings, а затем команду /plugin install qa@claude-settings. Второй вариант — запустить npx skills add fcakyon/claude-codex-settings --skill setup -a claude-code.
Что делает скилл setup?
Скилл запускает аудит репозитория через project-qa, находит маршруты и манифесты, после чего создаёт файлы прогона QA. Он помогает преобразовать черновые шаблоны проверок в сквозные интеграционные сценарии.
Что нужно для работы setup?
Требуется выполнить npm ci --prefix <plugin-root> и запускать node <plugin-root>/scripts/qa.mjs либо связать раннер через npm link. В CI при работе от root над чужим репозиторием путь обязательно вносят в git safe.directory.
Исходный текст
SKILL.md · Apache-2.0
--- name: setup description: This skill should be used when user asks to "set up QA", "create real integration tests", or "add project QA journeys" for websites, extensions, Android apps, native macOS apps or backends. --- # Set up project QA The plugin supplies the runner. The project owns journeys, selectors, fixtures and outcome assertions. Execution belongs in tracked scripts. Skills guide discovery and interpretation. 1. Run `npm ci --prefix <plugin-root>` once. Use `node <plugin-root>/scripts/qa.mjs` directly, or `npm link` from the plugin directory to install `project-qa`. In CI, pin the plugin to a commit and bump it on purpose. When CI runs as root over a checkout owned by another user, add it to git's `safe.directory`, or reports record an empty revision and a clean tree. 2. Run `project-qa discover --root <repo>`. Read the owning routes, callers, test commands, manifests and related repositories. Discovery identifies candidate coverage, not working features. 3. Run `project-qa setup --root <repo> --base-url <verified-url>`, adding `--extension <built-directory>` and repeated `--related <relative-repo>` where relevant. It creates `.agents/qa/config.json`, `.agents/qa/suite.mjs` and `.agents/skills/qa/SKILL.md`. Existing files are preserved. Discovery evidence stays in command output, so runtime configuration does not become a stale copy of package manifests. 4. Replace generated blocked cases with real journeys using [the API](../../references/runner.md) and [surface requirements](../../references/surfaces.md). Reuse existing integration tests before writing another owner for the same contract. 5. Configure [sessions](../../references/sessions.md) and [telemetry isolation](../../references/telemetry.md) before live runs. Test accounts have ordinary product permissions. 6. For a native macOS project, wire its real sandboxed Swift owner suite and app self-test into a macOS CI job. Reuse the same command locally and in CI through the shared macOS test CLI or `qa.swiftTests`. Require process success, positive test counts and no skipped tests. Linux adapter checks cannot replace this job. Verify the job is a required release check and executes on the candidate commit. 7. Run the suite, inspect failures, repair incorrect test assumptions, and rerun affected journeys. Run setup again to verify it preserves specialization. Update the local skill with commands and observed coverage. For a repaired bug, follow the regression and CI-selection guidance in [surface requirements](../../references/surfaces.md). Retain pure algorithm tests with meaningful edge cases. Remove mocked transport tests only after real journeys prove the same contract. A mocked expired-session response does not prove a provider's actual rejection. A root-page response, discovered component or assertion-free test is not full coverage. Missing credentials, unavailable titles, MFA and absent devices are blocked coverage. Expected outcomes come from independent fixtures and user contracts, not the implementation being tested. For native macOS permission onboarding, read [the native workflow](../../references/macos.md) and complete its capture-readiness steps before GUI work. The agent must inspect real journey screenshots before claiming UI acceptance. Ask the user only for an OS action they must perform. The shared driver supplies exact AX window selection, native mouse input and scoped captures. Projects own selectors and app outcomes. Run nonmutating protocol and signed-fixture checks in CI, with installed grants only in a separately authorized manual-live run.
© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — setup от других авторов.