메뉴
テスト設計・戦略の汎用ガイド（テストツール非依存）。テストピラミッド、テストレベルの選択基準、何をテストすべきかの優先順位、テストダブルの選択（Stub/Mock/Fake/Spy）、テスト設計パターン（AAA/GWT）、命名規則、アンチパターン、新機能/バグ修正/レガシーコードごとのテスト戦略、テストカバレッジの考え方をカバー。テスト方針決定、テストレベル選択、テスト設計時に使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Generate draw.io diagrams as .drawio files, optionally export to PNG/SVG/PDF with embedded XML
Figma MCP を使ってデザインを FE コードに変換するスキル。 Trigger when: Figma URL が共有された時、デザインからコンポーネント実装時、 UI 実装でデザイン参照が必要な時、"Figma", "デザイン", "UI実装" への言及時、 「このデザインを実装して」「Figma から」「デザイン通りに」と言われた時。 Always use with: /web-design-principles
プロジェクト全体の統括エージェント向けスキル。要件整理から技術選定・アーキテクチャ設計・タスク分解・委譲までをカバー。git worktreeを活用した並列開発オーケストレーション（featureブランチ管理、BE/FE統括への委譲、横断レビュー）も担う。プロジェクト全体を俯瞰し、適切なエージェント/スキルに委譲する。新規プロジェクト立ち上げ、技術選定、全体設計、タスク分解・委譲、並列開発時に使用。
Webデザイン実装の鉄則ガイド。CSS/レイアウト設計の原則を提供。 Trigger when: UI/UX実装時、CSS設計時、レイアウト実装時、レスポンシブ対応時、 アクセシビリティ確認時、"レイアウト", "CSS", "スタイル" への言及時。 /figma-to-code スキルと併用する場合に自動で参照される。
Codex CLIワーカーエージェントを起動してタスクを実行する。 Claude CodeがオーケストレーターとしてCodexを呼び出すハイブリッド構成。 トリガー: 「Codexで実行」「Codexに任せて」「並列でCodex」「高速に処理」
CSS の包括的なベストプラクティスガイド（フレームワーク非依存）。パフォーマンス最適化、保守性、シンプルなコード、親子要素の相対値設計、モダン CSS 機能（Container Queries、:has()、ネイティブネスティング、Cascade Layers）をカバー。CSS 設計・実装・レビュー時に使用。Tailwind CSS 等のユーティリティフレームワーク使用時は tailwind-css スキルを参照。
| name | test-design |
| description | テスト設計・戦略の汎用ガイド（テストツール非依存）。テストピラミッド、テストレベルの選択基準、何をテストすべきかの優先順位、テストダブルの選択（Stub/Mock/Fake/Spy）、テスト設計パターン（AAA/GWT）、命名規則、アンチパターン、新機能/バグ修正/レガシーコードごとのテスト戦略、テストカバレッジの考え方をカバー。テスト方針決定、テストレベル選択、テスト設計時に使用。 |
テストの設計・戦略に関する汎用ガイド。特定のテストフレームワークには依存しない。
/\
/ \ E2E（少）
/────\ ユーザーフロー全体
/ \
/────────\ 統合（中）
/ \ コンポーネント間連携
/────────────\ ユニット（多）
/ \ 関数・クラス単体
原則: 下層ほど多く・高速・安定、上層ほど少なく・遅い・不安定
| レベル | 対象 | 特徴 |
|---|---|---|
| ユニット | 純粋関数、ビジネスロジック、ユーティリティ、状態変換 | 高速、独立、デバッグ容易 |
| 統合 | API エンドポイント、DB 操作、外部サービス連携、コンポーネント間連携 | 実際の連携検証、セットアップ必要 |
| E2E | クリティカルなユーザーフロー、決済・認証 | 最も現実的、遅い、不安定になりやすい |
単体で検証可能な純粋ロジック？
├→ Yes → ユニットテスト
└→ No → 複数コンポーネントの連携が関わる？
├→ Yes → 統合テスト
└→ No → ユーザーの操作フロー全体を検証？
├→ Yes → E2E テスト
└→ No → ユニットテスト
| 種類 | 目的 | 使用場面 |
|---|---|---|
| Stub | 固定値を返す | 外部 API の戻り値を固定、特定の状態を再現 |
| Mock | 呼び出しを検証 | メソッド呼び出しの確認、引数の検証 |
| Fake | 簡易実装を提供 | InMemory Repository、状態を持つ代替 |
| Spy | 実装を維持しつつ記録 | 実際の処理 + 呼び出し回数の確認 |
呼び出しを検証したい？
├→ Yes → 実装も動かしたい？
│ ├→ Yes → Spy
│ └→ No → Mock
└→ No → 状態を持つ必要がある？
├→ Yes → Fake
└→ No → Stub
1. 境界でのみダブルを使う（外部システム、時間、乱数）
2. Fake を優先（InMemory 実装は再利用可能、実際の動作に近い）
3. Mock は最小限に（副作用の検証時のみ）
4. 「何が呼ばれたか」より「何が起きたか」に注目
詳細: references/test-doubles.md
Arrange: 準備（データ、依存関係のセットアップ）
Act: 実行（テスト対象の呼び出し）
Assert: 検証（期待結果との比較）
Given: 前提条件（システムがこの状態のとき）
When: アクション（この操作を行うと）
Then: 期待結果（こうなるべき）
AAA: ユニットテスト向き（技術者視点）
Given-When-Then: 統合/E2E テスト向き（ビジネス視点）
{対象}_{条件}_{期待結果}
例:
calculateTotal_withEmptyCart_returnsZero
login_withInvalidPassword_throwsError
fetchUser_whenNotFound_returnsNull
- テスト名だけで何をテストしているか分かる
- 条件と期待結果を含める
- 実装詳細ではなく振る舞いを記述
原則:
- テストごとに独立したデータを用意
- 共有のテストデータに依存しない
- ファクトリ/ビルダーパターンでデータ生成を共通化
- 意味のあるデータを使う（マジックナンバーを避ける）
データ生成の階層:
1. テスト内で直接定義（最もシンプル）
2. ヘルパー関数/ファクトリ（再利用する場合）
3. Fixture（セットアップが複雑な場合）
| パターン | 問題 | 解決 |
|---|---|---|
| テストの相互依存 | 実行順序で結果が変わる | 各テストで状態をリセット |
| 過度なモック | 実装詳細に依存しすぎ | 境界でのみモック |
| 巨大なテスト | 1テストで多くを検証 | 1テスト1責務 |
| マジックナンバー | データの意図が不明 | 意味のある変数名 |
| テストの重複 | 同じことを複数箇所で検証 | 責務を明確に分離 |
| 脆いアサーション | 変更に弱い完全一致 | 本質的な部分のみ検証 |
| 条件分岐のあるテスト | テスト内に if 文 | ケースごとにテスト分離 |
| 非決定的テスト | 時刻・乱数で結果が変わる | 依存を注入可能に |
| コメントアウトされたテスト | 無効化されたテスト放置 | 削除するか修正 |
| アサーションなし | 何も検証していない | 必ず expect を含める |
詳細: references/anti-patterns.md
1. 要件からテストケースを洗い出す
2. 優先度でソート（ビジネスクリティカル → エッジケース）
3. ユニットテストから書く
4. 必要に応じて統合テスト追加
5. クリティカルパスは E2E テスト
1. バグを再現するテストを先に書く（Red）
2. 修正を実装（Green）
3. リファクタリング
4. 回帰テストとして維持
1. 変更箇所を特定
2. その箇所の現状動作をテスト化（Characterization Test）
3. テストが通ることを確認
4. 変更を加える
5. テストが通ることを再確認
原則:
- カバレッジは「テストの質」の指標ではない
- カバレッジが低い箇所を発見するための参考値
- 100% を目標にしない（投資対効果が低い）
推奨:
- ビジネスロジック: 80%+ を目安
- ユーティリティ: 90%+ を目安
- UI コンポーネント: 重要な操作フローをカバー
- 設定・ボイラープレート: カバレッジ対象外でも可
注意:
- カバレッジ閾値を CI に組み込む場合は段階的に引き上げる
- ブランチカバレッジ > ラインカバレッジ（条件分岐の網羅度）