test-runner

Auto Test Skill

コード変更後にテストを自動検知・実行する。テックスタックを自動判別し、適切なテストコマンドを選択する。

トリガー

明示的トリガー

• 「テスト走らせて」「テスト実行」「test」
• 「動作確認して」「CI回して」
• /test（旧command互換）

自動検知トリガー

• コードの実装が完了した直後（機能追加・バグ修正・リファクタリング）
• /ship の前段階として

手順

Step 1: テストフレームワーク自動検出

対象ディレクトリ（指定がなければカレントリポジトリ）で以下を検出:

検出ファイル	フレームワーク	テストコマンド
package.json (scripts.test)	npm/vitest/jest	npm test or npx vitest run
vitest.config.*	vitest	npx vitest run
jest.config.*	jest	npx jest
pytest.ini / pyproject.toml [tool.pytest] / conftest.py	pytest	pytest
go.mod	go test	go test ./...
Cargo.toml	cargo test	cargo test
Makefile (test target)	make	make test

複数検出した場合は全て実行する。 何も検出できない場合は「テストフレームワークが見つかりません」と報告。

Step 2: テスト実行

検出したコマンドを実行する。

• 特定ファイル/パッケージが指定されている場合はそれだけ実行
• 指定がなければ全体を実行

Step 3: 結果サマリー

テスト結果:
- passed: X件
- failed: X件
- skipped: X件

フレームワーク: pytest (自動検出)

Step 4: 失敗時の対応

• テスト失敗: エラー内容を分析し、修正案を提示
• 環境エラー: 依存関係のインストールや設定の確認を案内
• タイムアウト: テスト対象を絞って再実行を提案

注意

• テストが存在しない場合は「テストファイルがありません。書きますか？」と提案
• カバレッジオプションが利用可能な場合は --coverage 付きでの実行も提案
• テスト全通過後、/ship への移行を案内

設計原則

原則	出典	適用
自動検出優先	Convention over Configuration	テストフレームワークは設定ファイルから自動判別。ユーザーに聞かない
全テスト実行がデフォルト	CI/CD best practice	特定ファイル指定がなければ全体を実行。テストは漏れなく回す
失敗時は修正提案まで	reporting-protocol.md	テスト結果の報告で終わらず、エラー分析と修正案を提示する

Config

カテゴリ	キー	デフォルト値	説明
検出対象	test_config_files	package.json, vitest.config.*, jest.config.*, pytest.ini, pyproject.toml, conftest.py, go.mod, Cargo.toml, Makefile	テストフレームワーク検出対象ファイル
タイムアウト	test_timeout	120秒	テスト実行のタイムアウト上限
カバレッジ	coverage_flag	--coverage	カバレッジ取得時の追加フラグ

セキュリティ

N/A -- 外部通信・認証なし。ローカルテスト実行のみ。

BLOCKINGゲート

Step	失敗条件	動作
Step 1	テストフレームワークが検出できない	STOP + 「テストフレームワークが見つかりません」と報告
Step 2	テスト実行コマンドがエラー終了（環境不備）	STOP + 依存関係インストール案内
Step 2	テストタイムアウト	STOP + テスト対象を絞って再実行を提案

エスカレーション

状況	対応
テストフレームワークが複数検出され優先度不明	ownerに確認: 「pytest と npm test の両方が検出されました。両方実行しますか？」
テスト失敗が10件以上	ownerに確認: 「大量の失敗があります。全件修正 or 優先度の高いものから対応しますか？」
カバレッジが極端に低い（< 20%）	ownerに報告: 「カバレッジが低い状態です。テスト追加の優先度を確認させてください」

合成可能性

連携スキル	関係	トリガー
/ship	後工程	テスト全通過後に /ship を案内
parallel-tasks	並列	大規模テストを並列実行する場合にAgent Teamsを提案
leak-learner	学習	owner指摘をlessons/に記録

汎用性

企業固有値なし。テストフレームワーク検出パターンはConfig表で外部化済み。任意のプロジェクトで即利用可能。

他のスキルとの連携

スキル	関係	説明
/ship	後工程	テスト全通過後に /ship を案内
parallel-tasks	並列	大規模テストを並列実行する場合にAgent Teamsを提案
leak-learner	学習	owner指摘をlessons/に記録

やらないこと

• テストコードの自動生成（提案はするが、承認なしに書かない）
• 本番環境でのテスト実行
• テスト結果に基づくプロダクションコードの自動修正（修正案の提示のみ）