К основному содержанию
скилл CX Codex

setup · fcakyon, qa — скилл для Claude Code: что делает и как установить

Скилл setup для Claude Code разворачивает интеграционные тесты и пользовательские сценарии тестирования в проекте. Включается при запросах настроить сквозное тестирование или добавить QA-сценарии.

Apache-2.0 ★ 1 216 обновлён 2026-11-16

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install qa@claude-settings
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/setup/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

setup официальный anthropics Скилл setup проверяет, какие инструменты подключены, учит ваш стиль письма по отправленной почте и сразу строит стартовый дашборд без анкеты. Нужен при первом запуске. CX Codex +1 371установок setup Alireza Rezvani Скилл setup для Claude Code. Собирает настройки эксперимента autoresearch: цель, файл, команду оценки, метрику и направление улучшения. Запускает цикл оптимизации файла. CX Codex +1 1 480установок setup aws Скилл setup для Claude Code запускает настройку подключений к AWS DevOps Agent и AWS Security Agent. Запускает настройку при недоступности MCP-инструментов и начале работы с тулкитом. CX Codex +1 1 600установок setup marketcalls Скилл setup разворачивает виртуальное окружение Python для тестирования торговых стратегий на VectorBT и OpenAlgo. Настраивает зависимости, папки и файл .env. CX Codex +1 2 100установок setup assistant-ui Скилл setup для Claude Code устанавливает и настраивает assistant-ui через CLI. Он помогает создать приложение, добавить assistant-ui в Next.js-проект или обновить установку. CX Codex +1 6 400установок om-integration-tests open-mercato Скилл om-integration-tests помогает создавать и отлаживать E2E-тесты в живом приложении без угадывания селекторов. Исследует запущенный сервис через настроенный браузер и сохраняет привычный тестовый раннер репозитория. CX Codex +1 3 800установок testing sangrokjung Правило testing задаёт строгий TDD-процесс для Claude Code: планку покрытия от 80%, три уровня проверок и сценарии Playwright. CX Codex +1 ★ 880звёзд репо playwright-interactive-sandbox customware-ai Скилл playwright-interactive-sandbox организует итеративную проверку веб-интерфейса через постоянный Node.js-скрипт с Playwright. Он нужен для функционального и визуального QA. CX Codex +1 401установок qa-project-context kindlmann Сканирует репозиторий и создаёт файл .agents/qa-project-context.md со стеком, тестами и рисками. Пригодится при настройке тестирования перед запуском других QA-скиллов. CX Codex +1 1 800установок ai-bug-triage kindlmann Скилл ai-bug-triage выстраивает гибридный пайплайн триажа багов: нормализует логи CI, дедуплицирует ошибки по отпечаткам и поручает модели оценку критичности и составление тикетов. CX Codex +1 1 700установок shiplight ShiplightAI Скилл-роутер для тестов и QA: принимает подкоманду и передаёт её нужному сценарию Shiplight. Срабатывает только когда вы явно назвали shiplight. CX Codex +1 539установок

Из того же набора113

Весь набор →
ui-measure-views Правило ui-measure-views предписывает измерять размеры View в React Native через связку useLayoutEffect и onLayout, предотвращая лишние ререндеры. CX Codex +1 ★ 1 216звёзд репо create-issue Скилл create-issue для Claude Code помогает создать или переписать issue: оформить баг, запросить функцию или улучшить заголовок и описание. Перед публикацией он проверяет шаблон репозитория и ищет похожие обращения. CX Codex +1 ★ 1 216звёзд репо list-performance-item-memo Правило list-performance-item-memo для строк списка в React: отдавать в элемент отдельные примитивы вместо объекта целиком, чтобы memo() сравнивал props и не перерисовывал строку без изменений. CX Codex +1 ★ 1 216звёзд репо react-state-dispatcher Правило react-state-dispatcher требует передавать колбэк-апдейтер в setState, когда новое значение зависит от текущего. Защищает от устаревших замыканий и лишних перерисовок. CX Codex +1 ★ 1 216звёзд репо list-performance-inline-objects Правило list-performance-inline-objects запрещает создавать объекты внутри renderItem для передачи в пропсы. Встроенные объекты создают новые ссылки на каждом рендере и ломают мемоизацию. CX Codex +1 ★ 1 216звёзд репо setup Команда setup настраивает ключ API для MCP-сервера Tavily в Claude Code и сохраняет его в конфигурационном файле плагина. CX Codex +1 ★ 1 216звёзд репо bundle-analyzable-paths Правило bundle-analyzable-paths просит оставлять пути импортов и файлов понятными для статического анализа. Это помогает не расширять сборку и трассировку файлов без необходимости. CX Codex +1 ★ 1 216звёзд репо list-performance-item-expensive Правило list-performance-item-expensive запрещает тяжёлые элементы списка: запросы данных, лишние хуки и обращения к React Context прямо в renderItem. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой