ec-qa-expert
Advanced QA patterns for testing business logic, UI, and edge cases in e-commerce systems.
Install
mkdir -p .claude/skills/ec-qa-expert && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13939" && unzip -o skill.zip -d .claude/skills/ec-qa-expert && rm skill.zipInstalls to .claude/skills/ec-qa-expert
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
世界トップクラスのQAエンジニアとして、Multi-Vendor ECプロジェクトのテスト設計・実装・品質検証を行う。 単なるテスト作成にとどまらず、境界値、異常系、冪等性、競合状態を網羅した「壊れないシステム」を保証する。 「テストを書いて」「品質を上げて」「エッジケースを考慮して」といった指示に適用する。Key capabilities
- →Design test cases for Multi-Vendor EC projects
- →Implement Jest for unit and integration tests
- →Implement Playwright for UI and E2E tests
- →Apply Boundary Value Analysis and Equivalence Partitioning
- →Verify error handling for abnormal conditions
- →Ensure idempotency and handle race conditions
How it works
The skill applies testing strategies like Boundary Value Analysis and idempotency checks using Jest and Playwright to ensure system reliability.
Inputs & outputs
When to use ec-qa-expert
- →Designing test cases
- →Implementing e2e tests
- →Testing edge cases
- →Ensuring system robustness
About this skill
品質保証・QAエキスパート（World-Class Standard）
Overview
Jest (Unit/Integration) と Playwright (E2E) を駆使し、ビジネスロジックからUI/UXまで、プロジェクト全体の品質を保証します。
開発規約 (Rules & Best Practices)
1. テスト設計戦略
- ✅ 境界値分析 (BVA) & 同値分割 (EP): 入力値の最小・最大・無効値（例: 0円, 1円, 在庫数+1, 特殊文字）を必ず網羅する。
- ✅ 異常系 (Negative Testing): 権限不足 (Unauthorized/Forbidden)、DB接続失敗、外部API (Stripe/PayPal) タイムアウト等のエラーハンドリングを 100% 検証する。
- ✅ 冪等性 (Idempotency): 決済や注文など、同じ操作が2回行われてもデータが破損しない（二重決済防止等）ことを検証する。
- ✅ 競合状態 (Race Condition): 在庫の引き当てなど、同時実行時に整合性が保たれるかを意識する。
2. ユニット・統合テスト (Jest)
- ✅ Fixtures 活用:
src/config/test-fixtures.tsを使用し、型安全なデータ生成を行う。ハードコードは避け、必要に応じてPartial<T>でオーバーライドする。 - ✅ 相対日付:
src/config/test-scenarios.tsの相対日付（now(),tomorrow()）を使用し、テスト実行時の日付に依存しない堅牢なテストを書く。 - ✅ モック戦略:
jest.spyOnやjest.mockを使用し、テスト終了後は必ずmockRestore()する。DBはMockPrismaClientを活用する。 - ✅ 配置: 原則としてソースファイルと同階層に
.test.tsで配置する。
3. UI・E2Eテスト (Testing Library / Playwright)
- ✅ User-Centric Testing:
getByRole,getByLabelTextなど、ユーザーが認識する要素でのセレクタ選択を優先する（実装詳細に依存しない）。 - ✅ データ属性: 最終手段として
data-testidを使用する。 - ✅ E2E安定性:
tests/e2e/seed/を使用して、各テストワーカーに独立したデータセットを用意し、並列実行時の干渉を防ぐ。
Step-by-Step Guide
- マインドセット: 「どうすればこのシステムを壊せるか？」という視点でテストケースを洗い出す。
- テストインフラ確認:
src/config/配下の共通定数・ヘルパーを確認し、車輪の再発明を避ける。 - カバレッジと質: 命令網羅だけでなく、条件網羅 (C1)・判定条件網羅 (C2) を意識したケースを作成する。
- 回帰防止: 修正したバグが二度と発生しないよう、そのバグを狙い撃ちしたテストを組み込む。
- ドキュメント更新（必須）: テスト実装完了後、以下を必ず更新してコミットする。
テスト実装後のドキュメント更新義務
テストを追加・変更した場合、コードと同一コミット or 直後のコミットで以下を更新すること。
| 更新ファイル | 更新内容 | 必須条件 |
|---|---|---|
docs/testing/TEST_IMPLEMENTATION_PLAN.md | 完了 Step に ✅ Completed (日付) を付与 | Step が完了したとき |
docs/testing/QA_HANDOFF.md (SSOT) | テスト統計テーブル更新 + Open Issues 状態更新 + 次着手明記 + 「次回着手用 依頼プロンプト」セクション同期 | セッション終了時（必須）/ テスト統計変動時 / Next Actions 変動時 |
docs/testing/COVERAGE_REPORT.md §3 | タスク（A/B/C）の完了記録・ヒートマップ更新 | セル状態（◯/◐/✦）が変化したとき |
docs/testing/SECURITY_GAP_REPORT.md | IDOR/RBAC の発見・修正・テスト追加を記録 (3 階層パターン (a)(b)(c) 必須) | セキュリティ脆弱性の修正時 |
docs/PROGRESS.md | テスト統計（テスト数・型エラー数）を QA_HANDOFF.md から転記同期 | 統計値が変化したとき |
scripts/coverage-dashboard/render-html.ts (SSOT) | NEXT_ACTIONS 配列の編集 (high/medium/low の追加・完了・削除) | Next Actions に変動があるとき |
docs/coverage-dashboard.html | bun run coverage:dashboard を実行して再生成 (手動編集禁止) | テストの追加/変更・カバレッジ更新時 / render-html.ts 編集時 |
重複防止: 即時 TODO は
QA_HANDOFF.mdのみに書く。COVERAGE_REPORT.md §3には「なぜやるか」の根拠のみ。 二重 SSOT 同期:scripts/coverage-dashboard/render-html.tsのNEXT_ACTIONS配列とQA_HANDOFF.md「次回着手用 依頼プロンプト」セクションは一対一で対応する。タスク完了/追加時は必ず両方を同一コミット内で更新すること（片方だけ更新すると drift する）。 詳細なルールは.claude/steering/documentation-guide.mdのdocs/testing/ 各ファイルの更新ルールおよび.claude/skills/spec-sync-after-test/SKILL.mdStep 3 (QA_HANDOFF.md 最優先) を参照。
When not to use it
- →When the task is not related to testing EC projects
- →When the user does not need to consider boundary values, abnormal conditions, idempotency, or race conditions
Limitations
- →Focuses on Multi-Vendor EC projects
- →Requires updating specific documentation files after test implementation
- →Relies on Jest for unit/integration and Playwright for E2E tests
How it compares
This skill focuses on preventing system breakage by proactively designing tests for edge cases and concurrency, rather than just basic functional testing.
Compared to similar skills
ec-qa-expert side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| ec-qa-expert (this skill) | 0 | 2mo | No flags | Advanced |
| ui-ux-expert-skill | 91 | 9mo | Review | Advanced |
| dependency-upgrade | 26 | 5mo | Review | Intermediate |
| vitest | 41 | 6mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
ui-ux-expert-skill
fercracix33
Technical workflow for implementing accessible React user interfaces with shadcn/ui, Tailwind CSS, and TanStack Query. Includes 6-phase process with mandatory Style Guide compliance, Context7 best practices consultation, Chrome DevTools validation, and WCAG 2.1 AA accessibility standards. Use after Test Agent, Implementer, and Supabase agents complete their work.
dependency-upgrade
wshobson
Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing. Use when upgrading framework versions, updating major dependencies, or managing breaking changes in libraries.
vitest
antfu
Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.
chrome-devtools
mrgoonie
Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.
playwright-browser-automation
lackeyjb
Complete browser automation with Playwright. Auto-detects dev servers, writes clean test scripts to /tmp. Test pages, fill forms, take screenshots, check responsive design, validate UX, test login flows, check links, automate any browser task. Use when user wants to test websites, automate browser interactions, validate web functionality, or perform any browser-based testing.
angular-best-practices
sickn33
Angular performance optimization and best practices guide. Use when writing, reviewing, or refactoring Angular code for optimal performance, bundle size, and rendering efficiency.