TDD Red階段（建立失敗的測試）

執行TDD的Red階段，建立會失敗的測試。

【功能名】：{{feature_name}}

事前準備

請確認以下文件已存在：

docs/tdd/{feature_name}/requirements.md
docs/tdd/{feature_name}/testcases.md

Red 階段目標

建立會失敗的測試，明確定義功能的行為。

重要原則：

測試必須是會失敗的（因為功能尚未實作）
測試要清楚定義預期的行為
測試要容易理解和維護

測試程式碼要求

1. 測試檔案結構

// 測試檔案：__tests__/{feature_name}.test.js

describe('{feature_name}', () => {
  // 【測試群組說明】：此群組測試的功能範圍

  test('測試案例名稱', () => {
    // 【測試目的】：說明此測試要驗證什麼
    // 【測試內容】：具體測試的處理
    // 【預期行為】：正常情況下的結果

    // Given - 準備測試資料
    // 【測試資料準備】：說明為何準備這些資料
    const input = testData;

    // When - 執行測試
    // 【執行功能】：呼叫要測試的功能
    const result = functionToTest(input);

    // Then - 驗證結果
    // 【驗證結果】：確認符合預期
    expect(result).toBe(expectedValue);
  });
});

2. 繁體中文註解規範

每個測試必須包含：

測試開始的註解：

// 【測試目的】：此測試要確認什麼功能
// 【測試內容】：具體要測試的處理
// 【預期行為】：正常情況下應該得到的結果

Given（準備）階段：

// 【測試資料準備】：說明準備這些資料的原因
// 【初始條件】：測試執行前的狀態

When（執行）階段：

// 【執行功能】：說明呼叫哪個功能
// 【處理內容】：這個功能做什麼處理

Then（驗證）階段：

// 【驗證結果】：要確認什麼結果
// 【預期值】：為什麼這是正確的結果

每個 expect 的註解：

expect(result.value).toBe(10); // 【確認】：數值正確為 10
expect(result.status).toBe('success'); // 【確認】：狀態為成功

實作步驟

選擇測試案例：
- 從 testcases.md 選擇要實作的測試
- 建議從最簡單的正常系統測試開始
建立測試檔案：
- 在適當位置建立測試檔案
- 設定測試框架和相關 import
撰寫測試程式碼：
- 按照 Given-When-Then 結構
- 加入完整的繁體中文註解
- 確保測試會失敗（功能尚未實作）
執行測試：
- 確認測試會失敗
- 失敗訊息要清楚易懂
記錄到 memo：
- 更新 docs/tdd/{feature_name}/memo.md
- 記錄 Red 階段的進度

memo.md 格式

# {feature_name} TDD 開發記錄

## Red 階段（建立失敗的測試）

### 日期
{當前日期時間}

### 已建立的測試
- 測試案例 1：{測試名稱}
- 測試案例 2：{測試名稱}
...

### 測試檔案位置
{測試檔案路徑}

### 預期的失敗
{說明為什麼這些測試會失敗}

### 下一步
進入 Green 階段，實作功能讓測試通過。

測試執行命令

根據使用的測試框架：

Jest/Vitest：

npm test
# 或
npm test -- {test_file_name}

其他框架： 請根據專案設定執行測試命令。

品質檢查

完成後請確認：

✅ 測試會失敗（因為功能未實作）
✅ 失敗訊息清楚易懂
✅ 測試有完整的繁體中文註解
✅ 測試結構清晰（Given-When-Then）
✅ 已記錄到 memo.md

下一步

Red 階段完成後，執行：

/tf-green

開始實作功能讓測試通過（Green 階段）。

/tf-red