smoke-check

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation,workflow,qa.level,testing.strict

スモークチェック

このスキルは、「実装完了」から「QAへの引き渡し準備完了」までのゲートです。自動テストスイートを実行し、テストカバレッジの不足を確認し、重要なパスを開発者とまとめて検証して、PASS／FAIL レポートを作成します。

ルールはシンプルです。スモークチェックに失敗したビルドは、QAに進みません。 壊れたビルドをQAに渡すと、時間を無駄にし、チームの士気を下げます。

出力： production/qa/smoke-[date].md

---

すべての AskUserQuestion 呼び出しは .claude/docs/automation-modes.md に従います （共同作業での質問は常に行う・ガイド付きでは主要なもののみ・自律モードでは記録して続行する。 automation_always_ask カテゴリーでは常に確認します）。

qa.level：minimal では、スモークチェックは任意です。実行した場合、FAILは参考情報として扱われ、引き渡しを妨げることはありません。また、ゲームテストがないプロジェクトでは、ビルド、起動、重要なパスのみで確認します（フェーズ1のステップ1）。standard では、フェーズの移行前に必須です。full では、すべてのコミット前に必須です。これはフェーズ6の testing.strict.config の解決よりも前に適用されます（スモークテストの実行がゲートとなる場合にのみ関係します）。workflow とは別の軸です。

引数の解析

引数は組み合わせて指定できます：/smoke-check sprint --platform console

基本モード（最初の引数。デフォルト：sprint）：

• sprint — 現在のスプリントのストーリーを対象に、完全なスモークチェックを実行します
• quick — カバレッジスキャン（フェーズ3）とバッチ3を省略します。迅速な再チェックに使用します

プラットフォームフラグ（--platform、デフォルト：なし）：

• --platform pc — PC固有のチェック（キーボード、マウス、ウィンドウモード）を追加します
• --platform console — コンソール固有のチェック（ゲームパッド、テレビのセーフゾーン、プラットフォームの認証要件）を追加します
• --platform mobile — モバイル固有のチェック（タッチ操作、縦向き／横向き、バッテリー／熱関連の動作）を追加します
• --platform all — すべてのプラットフォームのバリエーションを追加します。プラットフォームごとの判定表を出力します

--platform が指定されている場合、フェーズ4ではプラットフォーム固有のバッチを追加し、フェーズ5では全体の判定に加えて、プラットフォームごとの判定表を出力します。

---

フェーズ1：テスト環境の検出

今すぐ references/1-detect-setup.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮された場合や再開された場合は、もう一度読んでください。

フェーズ2：自動テストの実行

今すぐ references/2-run-tests.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮された場合や再開された場合は、もう一度読んでください。

フェーズ3：テストカバレッジの確認

今すぐ references/3-coverage.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮された場合や再開された場合は、もう一度読んでください。

フェーズ4：手動スモークチェックの実行

今すぐ references/4-manual-checks.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮された場合や再開された場合は、もう一度読んでください。

フェーズ5：レポートの作成

今すぐ references/5-report.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮された場合や再開された場合は、もう一度読んでください。

フェーズ6：書き込みとゲート判定

今すぐ references/6-write-gate.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮された場合や再開された場合は、もう一度読んでください。

協調プロトコル

collaborative モード（デフォルト）で適用されます。 guided および autonomous モードについては、.claude/docs/automation-modes.md を参照してください。以下のルールは 協調モードで必要となる動作を示すものであり、すべてのモードに共通する動作ではありません。

• NOT RUN を自動的に FAIL として扱わないでください — NOT RUN として記録し、 ステータスは開発者が手動で確認できるようにしてください。未確認の NOT RUN は FAIL ではなく NOT ASSESSED となり、合格判定にもなりません。
• 失敗を自動修正しないでください — 失敗を報告し、解決が必要な内容を示してください。 ソースコードやテストファイルの編集は試みないでください。
• PASS WITH WARNINGS は QA への引き継ぎを妨げません — /story-done が後で対応するための 参考情報としての課題を記録します。
• quick 引数を指定すると、Phase 3（カバレッジスキャン）と Phase 4 Batch 3 が スキップされます。特定の失敗を修正した後の迅速な再確認に使用してください。
• 手動のスモークチェックの確認には、すべて AskUserQuestion を使用してください。
• 確認を求めずにレポートを作成しないでください — Phase 6 では、ファイルを作成する前に明示的な 承認が必要です。