@dyoshikawa/tsumiki

# TDD Redフェーズ（失敗するテストを書く） TDDのRedフェーズを実行します。 ## 事前準備開発コンテキストの準備を行います： **Taskツール実行**: `/tdd-load-context` でTDD関連ファイルの読み込みとコンテキスト準備を実行読み込み完了後、準備されたコンテキスト情報を基にRedフェーズ（失敗テスト作成）の作業を開始します。 ## 対象テストケース **【対象テストケース】**: {{test_case_name}} ## 信頼性レベル指示テストコード作成時には、各テストケースの内容について元の資料との照合状況を以下の信号でコメントしてください： - 🟢 **青信号**: 元の資料を参考にしてほぼ推測していない場合 - 🟡 **黄信号**: 元の資料から妥当な推測の場合 - 🔴 **赤信号**: 元の資料にない推測の場合 ## 要件 - **使用言語/フレームワーク**: {{language_framework}} - テストは必ず失敗する状態で作成 - テスト名は分かりやすく日本語で記述 - アサーション（期待値の検証）を明確に記述 - まだ実装されていない関数・メソッドを呼び出す形で作成 ## テストコード作成指針 - Given-When-Then パターンを意識した構造 - テストデータの準備（Given） - 実際の処理の実行（When） - 結果の検証（Then） ## 日本語コメント必須要件テストコードには以下の日本語コメントを必ず含めてください： ### テストケース開始時のコメント ```javascript describe('{{feature_name}}', () => { test('{{test_case_name}}', () => { // 【テスト目的】: [このテストで何を確認するかを日本語で明記] // 【テスト内容】: [具体的にどのような処理をテストするかを説明] // 【期待される動作】: [正常に動作した場合の結果を説明] // 🟢🟡🔴 信頼性レベル: [このテストの内容が元資料のどの程度に基づいているか] // 【テストデータ準備】: [なぜこのデータを用意するかの理由] // 【初期条件設定】: [テスト実行前の状態を説明] const input = {{test_input}}; // 【実際の処理実行】: [どの機能/メソッドを呼び出すかを説明] // 【処理内容】: [実行される処理の内容を日本語で説明] const result = {{function_name}}(input); // 【結果検証】: [何を検証するかを具体的に説明] // 【期待値確認】: [期待される結果とその理由を説明] expect(result).toBe({{expected_output}}); // 【確認内容】: [この検証で確認している具体的な項目] 🟢🟡🔴 }); }); ``` ### セットアップ・クリーンアップのコメント（必要に応じて） ```javascript beforeEach(() => { // 【テスト前準備】: [各テスト実行前に行う準備作業の説明] // 【環境初期化】: [テスト環境をクリーンな状態にする理由と方法] }); afterEach(() => { // 【テスト後処理】: [各テスト実行後に行うクリーンアップ作業の説明] // 【状態復元】: [次のテストに影響しないよう状態を復元する理由] }); ``` ### 各expectステートメントのコメント各expectステートメントには必ず日本語コメントを付けてください： ```javascript expect(result.property).toBe(expectedValue); // 【確認内容】: [この検証で確認している具体的な項目と理由] expect(result.array).toHaveLength(3); // 【確認内容】: [配列の長さが期待値と一致することを確認する理由] expect(result.errors).toContain('error message'); // 【確認内容】: [特定のエラーメッセージが含まれることを確認する理由] ``` ## 作成するテストコードの例 ```javascript // テストファイル: {{test_file_name}} describe('{{feature_name}}', () => { beforeEach(() => { // 【テスト前準備】: 各テスト実行前にテスト環境を初期化し、一貫したテスト条件を保証 // 【環境初期化】: 前のテストの影響を受けないよう、ファイルシステムの状態をクリーンにリセット }); afterEach(() => { // 【テスト後処理】: テスト実行後に作成された一時ファイルやディレクトリを削除 // 【状態復元】: 次のテストに影響しないよう、システムを元の状態に戻す }); test('{{test_case_name}}', () => { // 【テスト目的】: {{test_purpose}} // 【テスト内容】: {{test_description}} // 【期待される動作】: {{expected_behavior}} // 🟢🟡🔴 信頼性レベル: [このテストの内容が元資料のどの程度に基づいているか] // 【テストデータ準備】: {{test_data_reason}} // 【初期条件設定】: {{initial_condition}} const input = {{test_input}}; // 【実際の処理実行】: {{function_description}} // 【処理内容】: {{process_description}} const result = {{function_name}}(input); // 【結果検証】: {{verification_description}} // 【期待値確認】: {{expected_result_reason}} expect(result).toBe({{expected_output}}); // 【確認内容】: {{specific_verification_point}} }); }); ``` ## 提供してください 1. **テストコード**: 実行可能な形式で、必須の日本語コメント付き 2. **テスト実行コマンド**: どのように実行するか 3. **期待される失敗メッセージ**: どのようなエラーが出るか 4. **コメントの説明**: 各日本語コメントの意図と目的テストコード作成後、以下を実行してください： 1. **メモファイル作成・更新**: docs/implements/{{task_id}}/{feature_name}-memo.mdファイルにRedフェーズの内容を作成または追記 - 既存のメモファイルがある場合は、Redフェーズセクションを更新 - メモファイルが存在しない場合は新規作成 2. テストコードの設計内容をdocs/implements/{{task_id}}/{feature_name}-red-phase.mdに保存（既存ファイルがある場合は追記） 3. TODOステータスを更新（Redフェーズ完了をマーク） 4. **品質判定**: テストコードの品質を以下の基準で判定 - テスト実行: 実行可能で失敗することを確認済み - 期待値: 明確で具体的 - アサーション: 適切 - 実装方針: 明確 5. **次のステップ表示**: 判定結果に関わらず、次のお勧めコマンドを表示 - 「次のお勧めステップ: `/tdd-green` でGreenフェーズ（最小実装）を開始します。」 ## TDDメモファイル形式 docs/implements/{{task_id}}/{feature_name}-memo.mdファイルの形式： ```markdown # TDD開発メモ: {feature_name} ## 概要 - 機能名: [機能名] - 開発開始: [日時] - 現在のフェーズ: [Red/Green/Refactor] ## 関連ファイル - 要件定義: `docs/implements/{{task_id}}/{feature_name}-requirements.md` - テストケース定義: `docs/implements/{{task_id}}/{feature_name}-testcases.md` - 実装ファイル: `[実装ファイルのパス]` - テストファイル: `[テストファイルのパス]` ## Redフェーズ（失敗するテスト作成） ### 作成日時 [日時] ### テストケース [作成したテストケースの概要] ### テストコード [実際のテストコード] ### 期待される失敗 [どのような失敗が期待されるか] ### 次のフェーズへの要求事項 [Greenフェーズで実装すべき内容] ## Greenフェーズ（最小実装） ### 実装日時 [日時] ### 実装方針 [最小実装の方針] ### 実装コード [実際の実装コード] ### テスト結果 [テストが通った結果] ### 課題・改善点 [Refactorフェーズで改善すべき点] ## Refactorフェーズ（品質改善） ### リファクタ日時 [日時] ### 改善内容 [具体的な改善内容] ### セキュリティレビュー [セキュリティ面での確認結果] ### パフォーマンスレビュー [パフォーマンス面での確認結果] ### 最終コード [リファクタ後のコード] ### 品質評価 [最終的な品質評価] ``` ## 品質判定基準 ``` ✅ 高品質: - テスト実行: 成功（失敗することを確認） - 期待値: 明確で具体的 - アサーション: 適切 - 実装方針: 明確 ⚠️ 要改善: - テストが実行できない - 期待値が曖昧 - 実装アプローチが不明 - 複雑なテストケース ``` ## TODO更新パターン ``` - 現在のTODO「Redフェーズ（失敗テスト作成）」を「completed」にマーク - 失敗テスト作成フェーズの完了をTODO内容に反映 - 品質判定結果をTODO内容に記録 - 次のフェーズ「Greenフェーズ（最小実装）」をTODOに追加 ``` 次のステップ: `/tdd-green` でテストを通すための最小限の実装を行います。