test-quick について
test-runner エージェントに Tier 1 のユニットテストを委任するスキルです。変更対象の絞り込みや監視モードに対応し、遅いテスト層を除外します。
主な機能
- 01Tier 1 のユニットテスト実行
- 02任意のパスまたはパターン指定
- 03監視モードでの継続実行
- 04--affected による変更ファイルのテスト
- 05失敗時の即時停止
活用シーン
- 01小規模なリファクタリング後の確認
- 02TDD 中のユニットテストのフィードバック
- 03最近の変更が影響するファイルのテスト
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ laurigates/ claude-plugins --skill test-quickインストール後、Claude Code で/test-quickを入力して読み込まれたか確認します。
詳細
このスキルを使用する場面
| 次の場合にこのスキルを使用します… | 次の場合は test-full を使用します… |
|---|---|
| 30 秒未満でフィードバックを得るため、ユニットテストのみを実行する | PR の前にテストピラミッド全体(ユニット+統合+E2E)を実行する |
最近の変更の影響を受けるテスト(--affected)に限定する | すべての層にわたるカバレッジや HTML レポートを生成する |
| ユニットテストでウォッチモードの TDD を行う | 失敗した単一のファイルを反復して確認する(test-focus を使用) |
| 小規模なリファクタリング後に問題がないことを確認する | 前回の実行結果をトリアージする(test-analyze を使用) |
コンテキスト
- プロジェクトの種類:!
find . -maxdepth 1 \( -name 'pyproject.toml' -o -name 'package.json' -o -name 'Cargo.toml' -o -name 'go.mod' \) - テストディレクトリ:!
find . -maxdepth 2 -type d \( -path '*/tests/unit' -o -path '*/test/unit' -o -path '*/__tests__/unit' \) - 最後のテスト実行:!
find . -path '*/.pytest_cache/v/cache/*' -maxdepth 4 -name 'lastfailed'
パラメーター
$1:省略可能なパスまたはテストパターン--watch:継続的なフィードバックを得るため、ウォッチモードを有効にします--affected:前回のコミット以降に変更されたファイルのテストのみを実行します
タスク
このタスクを test-runner エージェントに委任してください。
Agent ツールで subagent_type: test-runner を指定し、高速なユニットテストのみを実行します。上記で収集したすべてのコンテキストを渡し、**Tier 1(ユニットテスト)**の実行を指定してください。
test-runner エージェントは、次の手順を実行します。
-
ユニットテストのみを実行する(目標:30 秒未満)
- 低速なテスト、統合テスト、E2E テストは除外します
- フレームワークに適したマーカーやフラグを使用します。
- pytest:
-m "not slow and not integration and not e2e" - vitest:
--exclude="**/e2e/**" --exclude="**/integration/**" - cargo:
--lib - go:
-short
- pytest:
-
オプションを適用する
--watchの場合:継続的にテストを実行します--affectedの場合:変更されたファイルのみをテストします
-
速やかに失敗させる:最初の失敗時に停止します(
-xまたは--bail) -
簡潔な出力を提示する
Unit Tests: [PASS|FAIL] Passed: X | Failed: Y | Duration: Zs Failures (if any): - test_name: Brief error (file:line) Rerun failed: [command] -
実行後の案内
- すべて成功した場合:開発を続行できます
- 失敗がある場合:先に修正してください(速やかに失敗させる原則)
- 30 秒を超える場合:最適化のため
/test:consultを提案します
エージェントには、次の情報を渡してください。
- 上記セクションのすべてのコンテキスト
- 解析済みのパラメーター
- 明示的な指示:Tier 1 のみを実行し、低速なテストはスキップする
エージェントは次の分野に精通しています。
- 階層化されたテスト実行
- 高速なフィードバックループ
- テストの分離と並列化
コメント
Markdown 対応