# 影片筆記：Claude Code 速成教學｜前 TikTok 工程師帶你學｜MCP, Skills, Subagents, Context, Vibe Coding

## 一句話總結
本影片由前 TikTok 工程師講解 Claude Code 的進階操作，涵蓋 14 個核心指令、Context（上下文）管理策略（Compact/Clear/Dump）、記憶與規則設定，以及 NCP、Skills 與 Sub-agents 的架構差異與應用。

## 核心重點
1.  **環境設定與登入**：支援訂閱制、官方 API Key 或第三方方案；建議自建 API Key 平臺以節省 Token 並解除限制。
2.  **14 個常用指令**：
    *   **Permissions**：控制工具存取權限（Bash、Read、Write）。
    *   **Model**：選擇模型（如 Opus、Sonnet 5）。
    *   **Effort**：設定模型努力程度（Low 至 Ultra Code），權衡成本、速度與準確性。
    *   **Plan**：計劃模式，分為手動、自動及混合模式，用於稽核計劃後執行。
    *   **Rewind & Resume**：版本回退與會話恢復。
    *   **CodeReview vs Security Review**：分別用於一般邏輯檢查與安全漏洞掃描。
3.  **Context（上下文）管理**：
    *   **Compact**：壓縮對話生成摘要，保留任務延續性。
    *   **Clear**：清空 Session 節省空間，建議拆分任務為獨立 Session，並可用 `resume` 恢復。
    *   **Dump to File**：將重要內容備份至專案檔案（如 MD），隨後清空 Session，新 Session 可讀取該檔案恢復上下文。
4.  **記憶與規則**：
    *   **Init**：自動生成 `.cloudb.md` 作為專案靈魂/基礎記憶。
    *   **Memory**：管理專案層級或使用者層級的模糊行為偏好。
    *   **Rules**：定義明確死板的行為規範（約 90%-95% 執行率）。
    *   **Auto Memory**：系統自動記憶開發偏好。
5.  **架構差異**：
    *   **NCP (Node Context Protocol)**：本地伺服器，作為大模型與外部工具（如 Figma、瀏覽器）的橋樑。
    *   **Skills**：將多個工具呼叫與邏輯聚集為單一技能，需手動觸發，不會自動載入 Context。
    *   **Sub-agents**：存放於 `.cloud` 資料夾，提供獨立 Context，避免與主 Agent 混合，適合平行執行特定任務（如 Code Review）。

## 詳細大綱

### 1. 課程介紹與初始設定
*   **適合對象**：現有使用者或準備導入者。
*   **教學模組**：14 個指令、規則與記憶、NCP/Skills/Plugins、Sub-agents、Context 管理。
*   **登入方式**：
    *   訂閱制。
    *   官方 API Key。
    *   第三方平臺方案（如 Amazon、Microsoft 提供額度）。
    *   **作者建議**：自建 API Key 平臺以節省 Token 並解除時間限制。

### 2. 14 個常用指令詳解
*   **Permissions (權限)**：控制工具對檔案讀寫及命令列執行的許可（全權開放或精細授權）。
*   **Model (模型選擇)**：選擇 Opus、Sonnet 5 等模型。
*   **Effort (努力程度)**：
    *   **Low**：快速、省成本、不思考。
    *   **Medium**：日常開發、明確規則。
    *   **High**：複雜功能、除錯，會進行多輪思考。
    *   **X-High**：深度探索、大量工具呼叫，接近 Max 性能但較便宜。
    *   **Max**：極高成本，用於敏感功能（如金流）。
    *   **Ultra Code**：最新模式，自動拆解 Workflow 與 Sub-agents，極高成本。
*   **Plan (計劃模式)**：
    *   先計劃後執行，避免無效修改。
    *   **執行模式**：
        *   手動：逐項確認。
        *   自動：僅寫檔案自動，Bash 需確認。
        *   全自動：背景分類器判斷風險（風險案例：可能誤刪重要資料）。
*   **Rewind (回退) & Resume (恢復)**：
    *   Rewind：回退至特定指令版本。
    *   Resume：恢復意外關閉的 Session。
*   **CodeReview vs Security Review**：
    *   CodeReview：通用程式碼檢查、邏輯、慣例。
    *   Security Review：專門針對 SQL Injection、XSS 等安全漏洞。

### 3. Context (上下文) 管理策略
*   **基本概念**：
    *   **Session**：單一對話會話。
    *   **Context**：大模型接受的上下文長度限制（約 1 Million Token）。
*   **Context 過滿的缺點**：Token 消耗增加（帳單變貴）、訂閱額度快速耗盡、模型認知重點模糊、效率與準確度下降。
*   **處理方式**：
    1.  **Compact 指令**：
        *   壓縮對話內容並生成摘要，而非刪除。
        *   優點：保留任務延續性，釋放空間供後續任務使用。
        *   技巧：可指定不壓縮的關鍵內容（如錯誤處理模式、資料庫 Schema）。
    2.  **Clear 指令與 Session 切換**：
        *   建議：將任務拆分為不相干的 A、B、C 任務，每個任務獨立 Session。
        *   優點：減少 Token 消耗，提升 Agent 專注度。
        *   恢復機制：使用 `resume` 指令找回被刪除的 Session 內容。
    3.  **Dump to File 指令**：
        *   功能：將對話中有價值的內容備份至專案目錄（如 `Docs` 資料夾下的 MD 檔案）。
        *   優點：避免壓縮遺失重要資訊，可隨時讀取備份檔案載入新 Session。
        *   對比：比 Compact 更可控，確保重要資訊不被模型誤判壓縮。

### 4. 記憶（Memory）與規則（Rules）管理
*   **Init 指令與 `.cloudb.md`**：
    *   自動生成專案記憶檔案，記錄專案結構與重點。
    *   特性：每次 Session 自動載入，視為 Agent 工作的「靈魂」或行為準則。
    *   限制：非強制性約束，模型可能因 Context 混亂而忽略。
*   **Memory 指令**：
    *   分類：專案層級記憶 vs. 使用者層級記憶（跨專案通用）。
    *   用途：管理模糊的行為偏好（如使用特定指令、查看特定檔案）。
*   **Rules 檔案**：
    *   定義：明確、死板的行為規範（如狀態管理使用特定 Library、禁止列印 API Key）。
    *   執行率：約 90%-95% 機率會遵守，但 Context 混亂時可能失效。
*   **Auto Memory**：
    *   功能：系統自動記憶開發偏好（如使用 REAT 框架），儲存於 `Auto Memory` 資料夾。

### 5. NCP、Skill 與 Plugin 的架構
*   **NCP (Node Context Protocol)**：
    *   定義：本地伺服器，作為大模型與外部工具（如 Figma、瀏覽器）的橋樑。
    *   作用：賦予模型讀取設計稿、操作瀏覽器等能力。
*   **Skill**：
    *   定義：將多個工具呼叫（NCP）與邏輯聚集為專屬技能。
    *   觸發：需手動指定或特定情境觸發，不會自動載入 Context。
    *   內容：可包含指令碼路徑，用於處理複雜任務（如自動充值、爬蟲）。
*   **Plugin**：
    *   定義：將 Skill 與 NCP 打包，方便團隊成員安裝與分享。
*   **Cloud MD 與 Skill 的區別**：
    *   Cloud MD：背景資料，每次自動載入，定義專案基本行為。
    *   Skill：主動技能，需觸發才執行，可包含程式碼與輸出結果。

### 6. Sub Agent 的應用
*   **定義與優勢**：
    *   存放於 `.cloud` 資料夾。
    *   核心價值：提供獨立的 Context，避免與主 Agent 的 Context 混合導致專注度下降。
    *   平行執行：處理特定任務時，不與主 Context 共享，保持專注。
*   **運作機制**：
    *   透過平行執行特定任務，Sub Agent 能更專注於單一目標（如 Code Review）。
    *   主 Agent 可透過複製路徑呼叫 Sub Agent。
    *   執行結果會在介面下方獨立顯示，確保上下文隔離。
*   **設定方式**：使用 MD 格式撰寫，可手寫、使用網路範本或讓 AI 自動生成。
*   **範例**：建立 `co-review` 的 Sub Agent，定義任務、規則與 Workflow。

## 工具 / 模型 / 名詞整理
*   **Cloud Code**：主要教學工具。
*   **Opus**：提及使用的模型名稱。
*   **Sonic 5** (聽似 Sonnet 5，依逐字稿記錄)：提及可選擇的模型。
*   **NCP (Node Context Protocol)**：本地伺服器，作為大模型與外部工具的橋樑。
*   **Skills**：將多個工具呼叫與邏輯聚集為單一技能。
*   **Plugins**：將 Skill 與 NCP 打包分享。
*   **Sub-agents**：提供獨立 Context 的代理程式。
*   **Effort**：設定模型執行任務的努力程度。
*   **Plan**：實作功能前的計劃模式。
*   **Rewind & Resume**：版本回退與會話恢復功能。
*   **CodeReview**：通用程式碼檢查。
*   **Security Review**：專門針對安全漏洞掃描。
*   **Compact**：壓縮對話內容並生成摘要。
*   **Clear**：清空當前 Session。
*   **Dump to File**：將對話內容備份至檔案。
*   **Init**：自動生成專案記憶檔案。
*   **Memory**：管理行為偏好。
*   **Rules**：定義明確的行為規範。
*   **Auto Memory**：系統自動記憶開發偏好。
*   **Figma**：工具/設計稿。
*   **React** (逐字稿聽寫為 "REAT")：框架。
*   **Redux** (逐字稿聽寫為 "糾臺")：狀態管理 Library。
*   **Bash**：命令列工具。
*   **NPM**：提及啟動服務的指令。
*   **Git**：提及用於版本控制的指令。
*   **SQL Injection**：安全漏洞類型。
*   **XSS**：安全漏洞類型。
*   **Amazon / Microsoft**：提及提供額度的平臺。
*   **Crowthor**：疑似模型或 Agent 名稱。
*   **Playwright** (聽似 playride)：疑似工具名稱。
*   **Codecode**：疑似產品名稱或口誤。
*   **Cloud MD / .cloudb.md**：檔案格式。
*   **Docs**：資料夾名稱。
*   **package JSON**：檔案。
*   **API Key**：金鑰。
*   **MD 檔案**：Markdown。

## 操作流程整理
1.  **初始設定**：
    *   選擇樣式與主題。
    *   登入（訂閱、API Key 或第三方方案）。
2.  **專案初始化**：
    *   使用 `Init` 指令生成 `.cloudb.md` 檔案。
    *   設定 `Rules` 檔案定義行為規範。
3.  **日常開發與指令使用**：
    *   設定 `Permissions` 控制權限。
    *   選擇 `Model` 與 `Effort` 等級。
    *   使用 `Plan` 模式進行計劃與執行。
    *   進行 `CodeReview` 或 `Security Review`。
4.  **Context 管理**：
    *   當 Context 空間不足時，選擇 `Compact`、`Clear` 或 `Dump to File`。
    *   若使用 `Clear`，可透過 `Resume` 恢復 Session。
5.  **進階功能應用**：
    *   設定 `NCP` 連接外部工具。
    *   建立 `Skills` 並打包為 `Plugins` 分享。
    *   建立 `Sub-agents` 存放於 `.cloud` 資料夾，透過複製路徑呼叫，實現上下文隔離與平行執行。

## 值得注意的限制或風險
1.  **Plan 模式風險**：全自動模式可能導致誤刪重要資料，需謹慎使用。
2.  **Rules 執行率**：Rules 檔案雖有約 90%-95% 執行機率，但在 Context 混亂時可能失效。
3.  **Context 過滿影響**：Context 過滿會導致 Token 成本增加、訂閱額度快速耗盡，且模型專注度下降。
4.  **Init 非強制性**：`.cloudb.md` 雖每次自動載入，但非強制性約束，模型可能忽略。
5.  **Skill 不自動載入**：Skills 不會自動載入 Context，需手動觸發或指定執行。

## 逐字稿辨識疑點
*   **供文池**：逐字稿出現「匯入到你日常開發的供文池」，疑為「工作流」或「開發環境」之聽誤。
*   **Codecode / Cloud call / Cloud後**：逐字稿中多次出現「Codecode」、「Cloud call」、「Cloud後」，疑為「Cloud Code」之聽誤或口誤。
*   **NCP**：逐字稿提及「什麼是 NCP」，疑為特定術語或聽誤（常見為 MCP 或類似架構名稱，但依規則不更正）。
*   **plugging**：逐字稿提及「什麼是 plugging」，疑為「Plugins」或「Plugins」之聽誤。
*   **sub-asian**：逐字稿提及「開好幾個 sub-asian 幫你去做事情」，疑為「sub-agents」之聽誤。
*   **contest**：逐字稿多次將「Context」聽寫為「contest」，例如「contest的一個基本概念」、「contest的一個視窗」。
*   **Effort / Efford**：逐字稿交替使用「Effort」與「Efford」，疑為同一指令之拼寫不一致。
*   **X-Hide**：逐字稿提及「X-Hide 的部分」，疑為「X-High」之聽誤。
*   **HCase**：逐字稿提及「多想一些這個 HCase」，疑為「Edge Case」或「Corner Case」之聽誤。
*   **Corefuel / co-review**：逐字稿提及「Corefuel」及「co-review」，疑為「CodeReview」之聽誤。
*   **A軍**：逐字稿提及「那時候 A軍就做這樣的事情了」，疑為「Agent」之聽誤。
*   **產案**：逐字稿提及「有發生過一個產案」，疑為「案例」之聽誤。
*   **投稿**：逐字稿提及「消耗了一個投稿」、「消耗了投稿」，疑為「Token」之聽誤。
*   **直信**：逐字稿提及「然後去做直信」，疑為「執行」或「確認」之聽誤。
*   **分類期望**：逐字稿提及「背景分類期望去判斷」，疑為「分類器」或「分類機制」之聽誤。
*   **17秒之前**：逐字稿提及「17秒之前去關掉的這個 session」，疑為「17 分鐘前」或特定時間點之聽誤，或為「17 個」之聽誤。
*   **callhold**：逐字稿提及「在 callhold 這個地方去輸入」，疑為「Cloud Code」或終端機輸入框之聽誤。
*   **Crowthor**：逐字稿提及「我們這個 Crowthor 它的一個外掛」，疑似為特定模型名稱或產品名稱，聽寫可能不準確。
*   **REAT 框架**：逐字稿提及「使用 REAT 框架」，疑似為 React 框架的聽寫錯誤，但依規則標為疑點。
*   **Cloud MD / .cloudb.md**：逐字稿中交替出現「Cloud MD」與「.cloudb.md」，以及「點 Cloud 的一個資料夾」，疑似為 `.cloudb.md` 或特定格式名稱，聽寫可能存在不一致。
*   **戳除你的方式**：語境不明，疑似「去除」或特定術語的聽寫錯誤。
*   **逆境定義好的一些模式**：語境不明，疑似「經過定義好的一些模式」或類似詞彙的聽寫錯誤。
*   **土度**：語境不明，疑似「態度」或「程度」的聽寫錯誤。
*   **糾臺**：語境不明，疑似「Redux」或特定狀態管理方案的聽寫錯誤，或為「Redux」的誤聽。
*   **off 有關的一些實作**：語境不明，疑似「API」或「App」的聽寫錯誤。
*   **playride**：語境不明，疑似「Playwright」或其他工具