run-smoke-tests について
変更の前後にエンドツーエンドのスモークテストを実行するコーディングスキルです。テストの選択、失敗調査、最小限の修正、安定性確認の再実行を案内します。
主な機能
- 01アプリの前提条件をビルド
- 02全体または対象を絞って実行
- 03トレースとログを調査
- 04最小限の修正後に再実行
- 05不安定なテスト結果を抑制
活用シーン
- 01アプリをエンドツーエンドで検証
- 02スモークテストの失敗を調査
- 03繰り返し実行して修正を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/run-smoke-testsを入力して読み込まれたか確認します。
詳細
スモークテストの実行
トリガー
変更の前後に、エンドツーエンドのスモーク検証が必要な場合です。
ワークフロー
- 対象アプリのビルドに必要なものを準備します。
- 該当するスモークテストスイートまたは対象を絞ったテストファイルを実行します。
- 失敗した場合は、トレースやログを調べて根本原因を特定します。
- 最小限の修正を適用し、安定するまで再実行します。
コマンドの例
# Run full smoke suite
npm run smoketest
# Run a specific smoke test file
npm run smoketest -- path/to/test.spec.ts
# Faster iteration when build artifacts are ready
npm run smoketest-no-compile -- path/to/test.spec.ts
ガードレール
- 壊れやすいタイムアウトより、決定的な待機とアサーションを優先します。
- 偽陽性による不安定さを減らすため、成功した修正も再実行します。
- 明示的に依頼され、文書化されている場合に限り、テストを隔離します。
出力
- テスト結果の概要
- 根本原因と修正内容
- 残っている不安定さのリスク（あれば）
コメント
Markdown 対応