フレーキーテスト防止

概要

フレーキー（不安定）なテストを検出・修正するスキル。非決定性の排除、リトライロジック、テスト安定性向上パターンを提供し、CI/CDパイプラインの信頼性を向上させる。

ワークフロー

Phase 1: フレーキーテスト検出

目的: 不安定なテストを特定し、原因を分類

アクション:

1. references/non-determinism-patterns.md で非決定性パターンを確認
2. scripts/detect-flaky-tests.mjs でテストの安定性を分析
3. 失敗パターン（タイミング、並列、外部依存）を分類

Task: agents/detect-flaky-tests.md を参照

Phase 2: 非決定性分析

目的: フレーキーテストの根本原因を特定

アクション:

1. タイミング依存（sleep、setTimeout）を特定
2. 外部依存（DB、API、ファイルシステム）を特定
3. 並列実行時の競合状態を分析

Task: agents/analyze-non-determinism.md を参照

Phase 3: 修正実装

目的: 安定性向上パターンの適用

アクション:

1. references/retry-strategies.md でリトライ戦略を確認
2. references/stability-checklist.md でチェックリストを確認
3. assets/stable-test-template.ts を参考に修正
4. 修正後のテストを検証

Task: agents/implement-fixes.md を参照

Task仕様ナビ

ベストプラクティス

すべきこと

• テスト失敗パターンを記録・分析する
• 固定時間待機（sleep）を条件付き待機に置き換える
• 外部依存をモック・スタブで置き換える
• テストデータを各テストで独立させる
• 並列実行時のリソース競合を防ぐ

避けるべきこと

• 失敗したテストを単にリトライで隠す
• グローバル状態に依存するテスト
• 実行順序に依存するテスト
• 共有リソースへの同時アクセス

リソース参照

references/（詳細知識）

assets/（テンプレート）

scripts/（検出・検証）

変更履歴