fix-tests

テストを修正する

ユーザー引数

ユーザーは、対象とするテストやモジュールを指定できます。

$ARGUMENTS

何も指定されていない場合は、すべてのテストを対象にします。

コンテキスト

ビジネスロジックの変更、リファクタリング、依存関係の更新後に、現在の動作や実装と一致しなくなったテストが失敗することがあります。このコマンドでは、専用エージェントを使って失敗したすべてのテストを自動的に修正します。

目標

現在のビジネスロジックと実装に合うように、失敗したすべてのテストを修正します。

重要な制約

• テストの修正に集中する — 絶対に必要な場合を除き、ビジネスロジックは変更しないでください
• テストの意図を維持する — テストが引き続き期待される動作を検証するようにしてください
• 「変更の複雑さを分析する」
  • 変更されたファイルが2つ以上ある場合、または1つのファイルに複雑なロジックが含まれる場合は、自分でテストを書かず、エージェントのオーケストレーションのみを行ってください
  • 変更されたファイルが1つだけで、変更が単純な場合は、自分でテストを書いてもかまいません

ワークフローの手順

準備

1. 利用可能であればsaddスキルを読む

   • 利用可能な場合は、エージェント管理のベストプラクティスを理解するためにsaddスキルを読んでください

2. テスト環境を把握する

   • @README.mdとpackage.json（または同等のプロジェクト設定ファイル）を読みます
   • テストとカバレッジレポートの実行コマンドを特定します
   • プロジェクトの構成とテスト規約を把握します

3. すべてのテストを実行する

   • 全テストスイートを実行し、基準となる結果を確認します

4. 失敗しているテストファイルをすべて特定する

   • テスト出力を解析し、失敗しているテストファイルの一覧を取得します
   • 並列エージェントで実行できるよう、ファイルごとにグループ化します

分析

5. テストを個別に実行できることを確認する
   • 任意のテストファイルを選びます
   • 選んだテストファイルだけを実行する適切なコマンドを見つけるよう、haikuエージェントを起動します
     • 個別のテストを確実に実行できるようになるまで、繰り返し試すよう指示します
   • エージェントの完了後、該当するテストファイルがあれば、特定のテストファイルを実行してみます
   • これにより、エージェントがテストを単独で実行できることを確認します

テストの修正

6. developerエージェントを並列で起動する

   • 失敗しているテストファイルごとに1つのエージェントを起動します
   • 各エージェントに、以下の明確な指示を提供します
     • コンテキスト：このテストを修正する必要がある理由（ビジネスロジックが変更されたため）
     • 対象：修正する特定のファイル
     • ガイダンス：テスト作成のベストプラクティスを確認するため、利用可能であればTDDスキルを読むこと
     • リソース：READMEと関連ドキュメントを読むこと
     • コマンド：このテストファイルを個別に実行する方法
     • 目標：テストが成功するまで繰り返すこと
     • 制約：テストを修正し、ビジネスロジックは修正しないこと（明らかに壊れている場合を除く）

7. すべての修正を検証する

   • すべてのエージェントの作業が完了したら、全テストスイートを再度実行します
   • すべてのテストが成功することを確認します

8. 必要に応じて繰り返す

   • まだ失敗しているテストがある場合は、手順5に戻ります
   • 残っている失敗に対してのみ、新しいエージェントを起動します
   • 合格率が100%になるまで続けます

成功基準

• すべてのテストが成功する ✅
• テストカバレッジが維持されている
• テストの意図が維持されている
• ビジネスロジックに変更がない（バグが見つかった場合を除く）

エージェントへの指示テンプレート

エージェントを起動する際は、以下のテンプレートを使用します。

The business logic has changed and test file {FILE_PATH} is now failing.

Your task:
1. Read the test file and understand what it's testing
2. Read TDD skill (if available) for best practices on writing tests.
3. Read @README.md for project context
4. Run the test: {TEST_COMMAND}
5. Analyze the failure - is it:
   - Test expectations outdated? → Fix test assertions
   - Test setup broken? → Fix test setup/mocks
   - Business logic bug? → Fix logic (rare case)
6. Fix the test and verify it passes
7. Iterate until test passes