run-smoke-tests について
run-smoke-tests は、変更前後のエンドツーエンドのスモークテストを支援するスキルです。準備、実行、失敗調査、最小限の修正と再実行を案内し、不安定なテストにも配慮します。
主な機能
- 01対象アプリのビルド前提を準備
- 02全体または対象を絞ったテストの実行
- 03失敗時のトレースとログの調査
- 04最小限の修正とテスト再実行
- 05テスト手順による不安定さの抑制
活用シーン
- 01アプリ変更後の検証
- 02単一のスモークテストファイルの実行
- 03スモークテスト失敗の原因調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ poteto/ plugins --skill run-smoke-testsインストール後、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 対応