# 影片筆記：如何让Claude Code真正听话【第 5 讲】

## 一句話總結

本講解強調開發效率低下的主因並非模型能力不足，而是需求描述不清；透過四步法讓 AI 協助撰寫高品質需求文件，並結合 VSCode 中的 Cloud Code Plan Mode（計劃模式），可將模糊構想轉化為具體開發計劃，從而降低溝通成本、節省 Token 並縮短開發時間。

## 核心重點

1.  **需求描述的關鍵性**：
    *   許多使用者花費大量時間溝通卻產出與預期不符的結果，原因在於初始需求未講清楚，而非模型笨拙。
    *   講好需求能提升開發效率、減少溝通成本、使專案更貼近預期，並節省 Token 消耗（降低成本）。

2.  **AI 協助撰寫需求文件的四步法**：
    *   **發送指令**：將特定 Prompt 複製並貼入 Cloud。
    *   **簡述需求**：提出模糊構想（例如：做一個番茄時鐘）。
    *   **確認細節**：
        *   AI 提出問題確認需求細節。
        *   使用者回答後，AI 再次確認。
        *   AI 列出技術方案及其優劣勢，使用者選擇合適方案（如方案 A：低門檻、易維護）。
    *   **生成文件**：AI 根據確認內容生成完整的詳細開發文件。

3.  **實作流程：從需求到開發**：
    *   **新建專案**：在 VSCode 建立新資料夾（範例名稱：Time）及 `.md` 文件 `Spec.md`。
    *   **導入需求文件**：從 Cloud 網頁複製 AI 生成的需求文件，貼入 VSCode 的 `Spec.md` 並儲存。
    *   **制定開發計劃（Plan Mode）**：
        *   在 VSCode 輸入框左下角切換至 **Plan Mode**。
        *   輸入指令 `Add`，選取 `Spec.md`。
        *   下達指令：「按照這個需求文件，制定詳細的開發計劃」。
        *   等待 AI 梳理計劃（約一分半鐘）。
    *   **開始開發**：在輸入框輸入「確認計劃並開始」並點擊發送，Cloud Code 即開始進行開發。

## 詳細大綱

### 一、 為什麼要講好需求？
*   **現狀問題**：許多使用者花費大量時間溝通，最終產出與預期不符。
*   **原因分析**：非模型笨拙，而是初始需求未講清楚。
*   **講好需求的好處**：
    *   提升開發效率。
    *   減少溝通成本。
    *   專案更貼近預期。
    *   節省 Token 消耗（降低成本）。

### 二、 如何讓 AI 協助撰寫需求文件（四步法）
1.  **發送指令**：將特定 Prompt 複製並貼入 Cloud。
2.  **簡述需求**：提出模糊的構想（例如：做一個番茄時鐘）。
3.  **確認細節**：
    *   AI 提出問題確認需求細節。
    *   使用者回答後，AI 再次確認。
    *   AI 列出技術方案及其優劣勢，使用者選擇合適方案（如方案 A：低門檻、易維護）。
4.  **生成文件**：AI 根據確認內容生成完整的詳細開發文件。

### 三、 實作流程：從需求到開發
1.  **新建專案**：
    *   開啟 VSCode。
    *   建立新資料夾（範例名稱：Time）。
    *   建立 `.md` 後綴的文件，命名為 `Spec.md`。
2.  **導入需求文件**：
    *   從 Cloud 網頁複製 AI 生成的需求文件。
    *   貼入 VSCode 的 `Spec.md` 並儲存（Command + S）。
3.  **制定開發計劃（Plan Mode）**：
    *   在 VSCode 輸入框左下角切換至 **Plan Mode**（計劃模式）。
    *   輸入指令 `Add`，選取剛保存的 `Spec.md`。
    *   下達指令：「按照這個需求文件，制定詳細的開發計劃」。
    *   等待 AI 梳理計劃（約一分半鐘）。
4.  **開始開發**：
    *   在輸入框輸入「確認計劃並開始」。
    *   點擊發送，Cloud Code 即開始進行開發。

## 工具 / 模型 / 名詞整理

*   **Cloud Code**：影片主要介紹的 AI 編程工具/模型。
*   **VSCode**：視覺化程式碼編輯器，用於專案管理與指令輸入。
*   **Cloud**：指代 Cloud Code 的網頁介面或對話視窗。
*   **Spec.md**：影片中使用的需求文件命名範例。
*   **Plan Mode**：Cloud Code 中的一種操作模式（計劃模式）。
*   **Prompt**：提示詞/指令。
*   **Token**：計費單位，用於衡量模型消耗。
*   **Command + S**：macOS 系統下的儲存快捷鍵。

## 操作流程整理

1.  **準備階段**：
    *   開啟 VSCode。
    *   建立新資料夾（範例：Time）。
    *   建立 `Spec.md` 文件。
2.  **需求生成階段（透過 Cloud 網頁介面）**：
    *   複製特定 Prompt 並貼入 Cloud。
    *   簡述模糊需求（如：番茄時鐘）。
    *   與 AI 互動確認細節，選擇技術方案。
    *   獲取 AI 生成的完整需求文件。
3.  **整合與計劃階段（透過 VSCode）**：
    *   將 AI 生成的需求文件複製並貼入 VSCode 的 `Spec.md`。
    *   儲存文件（Command + S）。
    *   在 VSCode 輸入框左下角切換至 **Plan Mode**。
    *   輸入指令 `Add` 並選取 `Spec.md`。
    *   輸入指令：「按照這個需求文件，制定詳細的開發計劃」。
    *   等待 AI 輸出計劃（約一分半鐘）。
4.  **執行階段**：
    *   在輸入框輸入「確認計劃並開始」。
    *   點擊發送，啟動開發流程。

## 值得注意的限制或風險

*   **需求清晰度影響結果**：若初始需求描述不清，即使模型能力強，最終產出仍可能與預期不符。
*   **溝通成本與 Token 消耗**：需求確認過程涉及多輪對話，若未妥善管理，可能增加溝通成本與 Token 消耗。
*   **技術方案選擇**：使用者需具備判斷技術方案優劣勢的能力，以選擇適合的方案（如低門檻、易維護）。
*   **等待時間**：AI 梳理計劃需要時間（約一分半鐘），使用者需耐心等待。

## 逐字稿辨識疑點

*   **實套**：逐字稿中出現「實套一遍」，疑為「實作」或「實測」之聽寫錯誤。
*   **定一個開發計劃**：語境中疑為「制定一個開發計劃」之口誤或聽寫錯誤。
*   **Cloud**：文中多次單獨使用「Cloud」指代工具，疑為「Cloud Code」的簡稱或口誤，需查證是否為特定產品名稱。
*   **Time**：資料夾名稱範例，疑為「Timer」或「Tomato Clock」相關命名，但依逐字稿保留為「Time」。

## 可延伸追問

*   如何撰寫更有效的 Prompt 來引導 AI 生成高品質需求文件？
*   Plan Mode 與其他模式（如 Chat Mode）在功能上有何具體差異？
*   若 AI 生成的開發計劃與預期不符，應如何進行修正或重新調整？
*   在不同技術方案之間，應依據哪些具體指標來進行選擇？
*   如何監控和優化開發過程中的 Token 消耗？