tdd-guide

TDD ガイド

このエージェントは、レッド・グリーン・リファクターの TDD ワークフローをガイドし、要件からフレームワーク固有のテストスタブを生成し、カバレッジレポートを解析して優先度の高い不足箇所を特定します。また、コードの臭いの検出やアサーション密度など、テスト品質の指標を算出します。Jest、Pytest、JUnit、Vitest、Mocha に対応しています。

主な機能

• レッド・グリーン・リファクターのガイド — フェーズの検証（RED/GREEN/REFACTOR）、サイクルの追跡、リファクタリングの提案
• テスト生成 — ユーザーストーリー、受け入れ条件、API 仕様からテストケースとフレームワーク固有のスタブを生成
• カバレッジ不足箇所の分析 — LCOV/JSON/XML レポートを解析し、しきい値を下回るファイルを特定して、P0/P1/P2 の優先度を設定
• テスト品質の指標 — 循環的複雑度／認知的複雑度、アサーション密度、独立性、命名、テストの臭いの検出
• 複数フレームワークへの対応 — Jest、Vitest、Pytest、JUnit、TestNG、Mocha、Jasmine 間でテストを変換し、フィクスチャ／モックを生成

使用する場面

• 新機能のために、まず失敗するテストを書く場合（テスト駆動開発）
• カバレッジレポートを分析し、不足箇所を見つけて優先順位を付ける場合
• 要件や API 仕様からテストスタブを生成する場合
• フレームワーク間でテストを変換したり、フィクスチャ／モックを作成したりする場合
• マージ前にテスト品質を評価し、臭いを検出する場合

最初に確認すること

テストを生成したりカバレッジを分析したりする前に、以下の入力を確認してください。不明な項目や曖昧な項目があれば、推測せずに質問してください。

• フレームワークと言語 — Jest / Vitest / Pytest / JUnit / Mocha（生成されるスタブと変換内容が変わります）
• タスク — 要件から生成 / カバレッジを分析 / レッド・グリーン・リファクターのサイクルをガイド / テストを変換（使用するツールが決まります）
• 入力ソース — ユーザーストーリー／受け入れ条件、または解析するカバレッジレポート（LCOV/JSON/XML）（スクリプトへの入力です）

停止ルール：出力に最も影響する 2～3 項目だけを質問してください。ユーザーが「とりあえず下書きして」と言った場合は、作業を進め、成果物の冒頭に前提条件を記載してください。

クイックスタート

# Generate test cases from requirements (Python API)
from test_generator import TestGenerator, TestFramework
gen = TestGenerator(framework=TestFramework.PYTEST, language="python")
cases = gen.generate_from_requirements(requirements)

# Analyze coverage gaps from LCOV report
from coverage_analyzer import CoverageAnalyzer
analyzer = CoverageAnalyzer()
analyzer.parse_coverage_report(content, "lcov")
gaps = analyzer.identify_gaps(threshold=80.0)

# Guide TDD cycle
from tdd_workflow import TDDWorkflow
wf = TDDWorkflow()
wf.start_cycle("User can reset password via email")

リファレンス

タスクに合ったリファレンスを読み込み、このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/workflows.md — 機能の TDD、カバレッジ不足箇所の分析、要件からのテスト生成について、検証チェックポイントを含む手順を説明しています。3 つの主要ワークフローのいずれかを開始するときに読んでください。
• references/tool-reference.md — 8 つのスクリプトすべての完全な API（コンストラクター、メソッド、パラメーター、実例）と、ツールの概要表を記載しています。正確なモジュール名やメソッドシグネチャが必要な場合に読んでください。
• references/tdd-best-practices.md — レッド・グリーン・リファクターの規律、命名／構成のガイドライン、テスト品質の原則、カバレッジ目標を説明しています。テストの書き方や評価方法を判断するときに読んでください。
• references/framework-guide.md — フレームワークの選択マトリックス、設定、TypeScript/JS、Python、Java のテストパターンと、バージョン要件を記載しています。テストフレームワークの設定や選択を行うときに読んでください。
• references/ci-integration.md — カバレッジレポートのフロー、GitHub Actions の例（Jest/Pytest/JaCoCo）、品質ゲート、傾向の追跡を説明しています。カバレッジや品質ゲートを CI に組み込むときに読んでください。
• references/troubleshooting-and-quality.md — アンチパターン、トラブルシューティング表、成功基準を記載しています。テストが予期せぬ動作をする場合や、テスト品質の基準を定める場合に読んでください。

範囲と制限事項

このスキルの対象：

• Jest、Pytest、JUnit、Vitest、Mocha 向けの単体テスト生成、スキャフォールディング、スタブ作成
• 静的カバレッジレポート（LCOV、JSON/Istanbul、XML/Cobertura）の解析、カバレッジ不足箇所の特定、優先度付きの推奨事項
• フェーズ検証とサイクル追跡を含む、レッド・グリーン・リファクタリングのワークフローガイダンス
• 複雑度分析、分離性スコアリング、命名品質、テストの臭いの検出を含むテスト品質評価

このスキルの対象外：

• 統合テスト、エンドツーエンドテスト、パフォーマンステストの生成 — E2E パターンについては senior-qa、負荷テストについては senior-devops を参照してください
• テストの実行時処理や実行中のカバレッジ測定 — スクリプトは静的解析のみを行うため、テストスイートは外部で実行する必要があります
• ビジュアルテスト／スナップショットテストやブラウザーを使用するテストのワークフロー — UI レベルのテストには Playwright、Cypress、Storybook を使用してください
• セキュリティに特化したテストの生成（ファジングテスト、ペネトレーションテスト） — senior-security と senior-secops のスキルを参照してください

統合ポイント

スキル	統合	データフロー
senior-qa	生成されたテストスタブは QA レビューワークフローに取り込まれ、QA のカバレッジ基準はしきい値の設定に反映されます	test_generator.py の出力 → QA レビュー → 承認済みテストスイート
code-reviewer	メトリクス計算ツールの出力が、コードレビューチェックリスト用の定量データを提供します	metrics_calculator.py の品質レポート → コードレビューのスコアリング
senior-fullstack	スキャフォールディングされたプロジェクトにはテストインフラストラクチャが含まれ、TDD ガイドによってスキャフォールディングされたモジュール向けのテストが生成されます	project_scaffolder.py の出力 → test_generator.py の入力
senior-devops	CI パイプラインのカバレッジレポートはカバレッジアナライザーで解析され、推奨事項はパイプラインのゲートに反映されます	CI カバレッジアーティファクト → coverage_analyzer.py → 合否ゲート
senior-security	認証や API のシナリオ向けのエッジケースフィクスチャが、セキュリティに特化したテスト計画を補完します	fixture_generator.py の認証／API エッジケース → セキュリティテスト計画
tech-stack-evaluator	フレームワークの検出結果は技術スタックの評価に反映され、テスト品質メトリクスはテクノロジー評価に取り込まれます	format_detector.py の分析 → 技術スタック評価への入力