/qa — 品質保証ワークフロー
このスキルを実行すると、最近の変更または特定のファイルに対して徹底的なQAを実行します。
最近変更されたファイル
!git diff --name-only HEAD~1 2>/dev/null | head -20 || echo "最近の変更は検出されませんでした"
フェーズ1: 偵察
- テストフレームワークを検出 — 以下のファイルを確認:
Gemfileに rspec/minitest → RSpec または Minitestmix.exs→ ExUnitpackage.jsonに jest/vitest → Jest または Vitestplaywright.config→ Playwright
- 変更されたファイルを特定 —
$ARGUMENTSがファイルパスの場合はそれを使用し、それ以外の場合はgit diff --name-only HEAD~1を実行 - 各ファイルをリスクレベルで分類:
- CRITICAL: 認証、支払い、データモデル、共有ユーティリティ、APIエンドポイント
- HIGH: ビジネスロジック、サービス、コントローラー
- MEDIUM: ビュー、シリアライザー、ヘルパー、設定
- LOW: ドキュメント、コメント、フォーマット
- 各変更ファイルとその既存テスト(あれば)を読み取る。 約5ファイル以上変更がある場合は、この読み取りを
codebase-explorerエージェントに委譲し、その要約から作業する — メインコンテキストは質問とテストのために確保する。 - コンテキストテーブルを作成:
| ファイル | 種類 | リスク | 既存テスト? |
|---|---|---|---|
| ... | ... | ... | ... |
フェーズ2: 質問
テストを書く前に、AskUserQuestion を使用して3~8個の質問を行います。 質問はグループ化し、一度に1つずつ尋ねないでください。
良い質問(リスクに焦点):
- 「これは支払いフローに影響します。返金のエッジケースをテストすべきですか?」
- 「新しいバリデーションは空入力を拒否します。Unicodeのみの文字列はどうしますか?」
- 「このサービスは外部APIを呼び出しています。モックにするか、統合テストをすべきですか?」
悪い質問(これらは尋ねない):
- 「このコードは何をしますか?」(自分で読むこと)
- 「テストを書くべきですか?」(はい、常に)
- 「どのテストフレームワークを使うべきですか?」(検出すること)
フェーズ3: テスト計画
仕様を書く前に、構造化されたテスト計画を提示してください。 カテゴリ別に整理:
テストカテゴリ
- ハッピーパス — 期待される入力が期待される出力を生成する
- エッジケース — 境界値、空入力、最大値、nil/null
- エラーケース — 無効な入力、ネットワーク障害、タイムアウト、権限拒否
- 異常/攻撃的 — SQLインジェクション文字列、スクリプトタグ、絵文字、10MB文字列、同時アクセス
- パフォーマンス — N+1クエリ、無制限コレクション、低速クエリ(CRITICAL/HIGHリスクのみ)
- 統合 — コンポーネント間の相互作用(複数ファイルが変更された場合のみ)
テーブルとして提示:
| # | カテゴリ | テスト説明 | リスクレベル |
|---|---|---|---|
| 1 | ハッピーパス | 有効なパラメータでレコードを作成 | HIGH |
| ... | ... | ... | ... |
続行する前にユーザーの承認を待ちます。
フェーズ4: 仕様作成
以下のパターンに従って仕様を作成:
- アサーションはテストごとに1つ(実用的な場合)
- 説明的な名前 —
it "レコードが見つからない場合404を返す"はit "動作する"ではない - Arrange-Act-Assert 構造
- ミステリーゲストなし — すべてのテストデータがテスト内で可視
- 実装ではなく振る舞いをテスト — プライベートメソッドを直接テストしない
- フレームワークに適したファクトリー/フィクスチャを使用
describe/contextブロックで振る舞いごとにグループ化
テストコードの品質
テストもコードです — 同じ原則を適用:
- KISS: 過度に設計されたテストヘルパーは不要。セットアップが10行を超える場合は、テストまたはテスト対象コードを簡略化する。
- YAGNI: 発生し得ないシナリオはテストしない。不可能な状態に対して「念のため」テストを追加しない。
- DRY(ただし抑制を): 巧妙な共有サンプルよりも明確な重複を優先。テストは3つのヘルパーファイルにジャンプすることなく、上から下まで読めるべき。
- クリーンコード: ドキュメントのように読める説明的なテスト名。ミステリーゲストなし — すべてのデータがテスト内で可視。
フレームワーク固有のテストノート(RSpec、Minitest、ExUnit、Jest/Vitest)については @reference.md を参照。
フェーズ5: 実行と検証
- 新しい仕様を実行 — 対象を絞った実行(新しいファイルのみ)
- 障害を修正 — エラーを読み、ソースを読み、根本原因を修正
- 全スイートを実行 — 他に何も壊れていないことを確認
- QAレポートを作成 — @reference.md のレポートテンプレート、コアバリュー監査、合理化チェックを参照。
評決: SHIP IT / FIX AND RE-TEST / NEEDS REWORK