# 影片筆記：Claude Code的3个高效开发&省钱技巧【第 6 讲】

## 一句話總結

本影片介紹使用 Cloud Code 進行開發時的三個高效技巧：建立 `Cloud.md` 專案說明書以減少 Token 消耗、直接複製瀏覽器控制台錯誤資訊以加速除錯，以及透過 `translog.md` 進行版本存檔與回退，確保專案穩定性。

## 核心重點

1.  **專案說明書（Cloud.md）**：
    *   針對大型專案，AI 每次重新熟悉專案會消耗大量 Token。
    *   使用指令 `-init` 讓 AI 自動生成 `Cloud.md`，記錄專案背景、架構、規則等。
    *   需養成習慣，在功能新增或修改後，同步更新此說明書。
2.  **精準回報問題（Bug Reporting）**：
    *   避免僅描述現象，應提供具體錯誤資訊。
    *   Web 應用：複製瀏覽器控制台的錯誤文案貼給 AI。
    *   非 Web 應用（如手機 App、小程序）：需找到對應調試頁面（如 iOS 用 Xcode）獲取錯誤資訊，若不知如何查找可詢問 AI。
3.  **版本管理與存檔（translog.md）**：
    *   類似遊戲存檔機制，用於在重大錯誤（如重構失敗）時快速恢復。
    *   建立 `translog.md` 版本記錄文件。
    *   日常操作包括：告知 AI 進行存檔、要求回退到特定版本、查看歷史記錄。

## 詳細大綱

### 1. 前言
*   歡迎進入 Cloud Code 基礎教程。
*   核心目標：高效開發與節省 Token 成本。

### 2. 技巧一：建立項目說明書
*   **痛點**：專案規模越大，AI 重新熟悉專案所需的時間與 Token 成本越高。
*   **解決方案**：
    *   使用指令 `-init` 讓 Cloud Code 生成項目說明書。
    *   說明書內容包含：專案概述、常用命令、架構說明、數據存儲、自定義接口、基礎規則。
    *   文件命名為 `Cloud.md`。
*   **維護規範**：
    *   當功能新增或修改後，必須同步更新說明書。
    *   可透過指令「更新 Cloud.md」來執行此操作。

### 3. 技巧二：快速訂閱（回報）問題
*   **痛點**：僅描述現象會導致 AI 靠猜測排除可能性，浪費時間與 Token。
*   **解決方案**：提供具體的錯誤資訊。
*   **Web 應用操作步驟**：
    1.  使用瀏覽器「檢查」功能開啟控制台。
    2.  複製控制台中的錯誤文案（例如顯示錯誤數量的圖標旁）。
    3.  將錯誤資訊貼入 Cloud Code 插件頁面，要求檢查並修復。
*   **非 Web 應用操作步驟**：
    *   若為手機 App 或小程序，需找到對應的調試頁面（例如 iOS 使用 Xcode）。
    *   若不知如何查找錯誤資訊位置，可詢問 Cloud Code，依其指引提供給 AI。

### 4. 技巧三：存档與版本管理
*   **概念**：類似遊戲存檔，用於在出現重大問題（如重構後專案無法運行）時，快速恢復到之前的正常狀態。
*   **操作步驟**：
    1.  從課程文檔複製「版本記錄規範」文案。
    2.  在 Cloud Code 專案說明書（`Cloud.md`）最後貼上並保存（Command S）。
    3.  讓 Cloud Code 建立初始版本記錄。
    4.  等待約 20 秒，生成版本記錄文件 `translog.md`。
*   **日常指令**：
    *   **存档**：有新記錄時告知 AI。
    *   **回退**：遇到問題時，要求回滾到之前的版本。
    *   **查看歷史**：告知 AI 或直接打開 `translog.md` 查看版本歷史。

### 5. 結語
*   建議無專業編程經驗的小白嘗試這些技巧。
*   歡迎在評論區提問或索取完整學習資料。
*   請求點讚與訂閱。

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

*   **Cloud Code**：影片主要討論的 AI 開發輔助工具/插件。
*   **BS Code**：逐字稿中提及的軟體環境（疑點：通常指 VS Code 或特定 IDE，但逐字稿原文為 BS Code）。
*   **Xcode**：iOS 應用調試工具。
*   **Cloud.md**：項目說明書的文件名稱。
*   **translog.md**：版本記錄的文件名稱。
*   **Web 應用 / 公眾號排版助手**：範例應用類型。
*   **iOS 應用 / 小程序**：範例應用類型。
*   **-init**：用於生成專案說明書的指令。

## 操作流程整理

### 流程一：初始化專案說明書
1.  在 Cloud Code 中輸入指令 `-init`。
2.  AI 生成 `Cloud.md` 文件，包含專案概述、架構、規則等資訊。
3.  後續開發中，若功能有變動，使用指令「更新 Cloud.md」同步資訊。

### 流程二：除錯 Web 應用
1.  在瀏覽器中開啟「檢查」模式進入控制台。
2.  複製控制台顯示的錯誤文案（注意圖標旁的錯誤數量提示）。
3.  將複製的內容貼入 Cloud Code 插件頁面。
4.  要求 AI 檢查並修復錯誤。

### 流程三：建立版本存檔系統
1.  複製課程文檔中的「版本記錄規範」文案。
2.  打開 `Cloud.md` 文件，將規範文案貼在最後。
3.  保存文件（Command S）。
4.  等待約 20 秒，確認系統生成 `translog.md` 文件。
5.  日常開發中，透過告知 AI 進行存檔，或在出錯時要求回退至 `translog.md` 中的特定版本。

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

*   **Token 消耗**：若未建立專案說明書，大型專案每次對話讓 AI 重新熟悉專案會導致高昂的 Token 成本。
*   **錯誤資訊準確性**：若僅描述現象而未提供具體錯誤資訊，AI 需靠猜測，可能導致除錯效率低下且浪費 Token。
*   **版本恢復依賴**：版本回退功能依賴於 `translog.md` 的正確建立與維護，若未及時存檔，可能無法恢復到理想的狀態。
*   **非 Web 應用調試難度**：對於手機 App 或小程序，用戶需自行掌握調試工具（如 Xcode）的使用，若無相關知識需依賴 AI 指引，增加了操作複雜度。

## 逐字稿辨識疑點

*   **BS Code / IBS Code**：逐字稿中多次出現「回到 BS Code 裡面的 Cloud Code 插件頁面」及「打開 IBS Code」。根據常見開發環境推測可能為聽寫錯誤，但依規則僅標記為「BS Code」或「IBS Code」，不自行更正為 VS Code 或其他名稱。
*   **translog.md**：逐字稿中明確提到版本記錄文件為 `translog.md`。通常版本日誌可能為 `changelog.md` 或 `history.md` 等，此處保留原文拼寫。
*   **X, X 的旁邊有一個數字 2**：描述瀏覽器控制台圖標時，原文為「X,X的旁邊有一個數字2」，語意稍顯重複或口誤，保留原文描述。
*   **Cloud.md**：作為項目說明書的文件名，保留原文拼寫。
*   **init**：指令部分寫作 `-init`，保留原文格式。

## 可延伸追問

1.  如何具體撰寫 `Cloud.md` 中的「基礎規則」以最大化 AI 的開發效率？
2.  對於非 Web 應用（如小程序），除了 Xcode 外，还有哪些常用的調試工具可以配合 Cloud Code 使用？
3.  `translog.md` 的具體格式規範是什麼？如何定義一個有效的「存檔點」？
4.  當專案規模極大時，是否有其他方法可以進一步壓縮 AI 處理專案上下文所需的 Token？
5.  如果 `translog.md` 文件損壞或遺失，是否有備份機制可以恢復版本記錄？