test-consult

コンテキスト

戦略的なテストの判断について、test-architecture エージェントに相談するための明示的なコマンドです。

次の場合に使用します：

• 新機能のテストを作成するとき
• テスト戦略の調整が必要なとき
• カバレッジの不足が見つかったとき
• 不安定なテストが検出されたとき
• フレームワークの選定について質問があるとき

トピック

トピック	内容
coverage	不足箇所を分析し、優先度の高いテストの作成を推奨します
strategy	テストアーキテクチャ全体とピラミッドをレビューします
framework	技術スタックに適したテストツールを推奨します
flaky	不安定なテストを診断し、改善します
pyramid	テスト階層の分布を分析します
new-feature	新機能のテスト方針を設計します
(自由入力)	テストに関するカスタムの質問

パラメーター

• $1：トピックのキーワードまたは自然言語での質問
• --context <path>：特定のディレクトリに分析対象を絞ります

動作

1. プロジェクトのコンテキストを収集：

   • テスト用のディレクトリと構成を特定します
   • 使用中のフレームワークを検出します（pytest、vitest、playwright など）
   • 利用可能な場合はカバレッジレポートを読み取ります
   • 最近のテスト失敗を確認します

2. test-architecture エージェントに委任：

   • 収集したコンテキストを提供します
   • 指定されたトピックを含めます
   • 実行可能な推奨事項を依頼します

3. 推奨事項を提示：

   • 戦略的なアドバイス
   • 具体的なアクション項目
   • イシューやタスクの作成を提案します

例

# Coverage analysis
/test:consult coverage

# New feature testing strategy
/test:consult new-feature --context src/auth/

# Framework decision
/test:consult "Should we add property-based testing?"

# Flaky test investigation
/test:consult flaky

# Custom question
/test:consult "How should we structure tests for our API endpoints?"

エージェントへの委任

このコマンドは、次の情報を添えて test-architecture エージェントに委任します：

• プロジェクトのテスト構成の分析
• カバレッジデータ（利用可能な場合）
• 指定されたトピック／質問
• コンテキストパス（指定されている場合）

エージェントからは、次の内容が提供されます：

• 戦略的な推奨事項
• 具体的で実行可能な項目
• トレードオフの分析
• 実装のガイダンス