先抓全貌
用最短時間掌握責任邊界與主流程,建立共同語言。
本教學採三層資訊架構:首頁先選模組,再進入主題群組頁,最後閱讀各章節的由淺入深內容。
同一章可以用不同方式讀,不需要被固定層級格式綁住。
用最短時間掌握責任邊界與主流程,建立共同語言。
聚焦關鍵判斷、狀態轉換與常見改動點,直接對應實作。
對照替代方案與失敗路徑,建立可維護的設計判斷。
所有章節遵循同一個閱讀順序,確保你在不同主題下也能維持一致節奏。
建議按階段前進,先看總覽,再依需求深入執行細節與取捨分析。
graph LR
subgraph phase1["基礎概念"]
A[快速起步] --> B[啟動流程]
B --> C[指令系統]
end
subgraph phase2["核心機制"]
C --> D[Skills 機制]
D --> E[工具系統]
E --> F[回合引擎]
F --> N[服務與 MCP]
end
subgraph phase3["進階架構"]
N --> G[狀態與任務]
G --> H[模式與權限]
H --> I[記憶系統]
I --> J[代理與擴充]
end
subgraph phase4["深入主題"]
J --> K[提示系統]
K --> L[Hooks 與自動化]
L --> M[終端 UI]
end
若你時間有限,可先依角色挑選章節,再回頭補完整路線。
| 角色 | 建議先讀 | 接著補讀 | 目標成果 |
|---|---|---|---|
| 第一次接觸 Claude Code | 快速起步 → 啟動流程 | 指令系統 → 工具系統 | 能說清楚系統從輸入到回應的主流程 |
| 日常使用者(想提升效率) | 指令系統 → 回合引擎 → 模式與權限 | Hooks 與自動化 → 提示系統 | 能設計穩定的工作流並避免常見誤用 |
| 維護者/架構導向讀者 | 工具系統 → 狀態與任務 → 記憶系統 | 代理與擴充 → 服務與 MCP → 終端 UI | 能評估設計取捨與擴充邊界 |
不用。先看首頁的角色路線快速上手,再補四階段路線,效率最高。
不必。建議先看總覽建立地圖,遇到工作需求時再下鑽細節段落。
先看「啟動流程、回合引擎、模式與權限」,這三章最能降低改動風險。
先用一頁掌握核心模組邊界與協作關係,再決定下一步要深讀哪個系統。
前往章節從第一個輸入到進入互動回合的啟動路徑,先看快速地圖再看啟動細節。
前往章節斜線命令如何註冊、過濾、路由,並與命令清單實際可見性銜接。
前往章節從 skills 載入、發現、觸發到 inline/fork 執行與權限邊界的完整路徑。
前往章節工具契約、組裝、過濾與操作風險判讀,包含完整工具/命令速查。
前往章節一次 submit 如何穿過系統提示、工具呼叫、串流輸出與收尾。
前往章節外部服務整合、MCP 工具資源注入與政策邊界的交會點。
前往章節狀態變化如何驅動互動,任務如何跨回合同步與追蹤進度。
前往章節工具呼叫前的安全閘門與模式切換,決定哪些操作可被執行。
前往章節Session 與持久記憶如何載入、合併與影響當前對話決策。
前往章節子代理、委派流程與擴充策略,如何在安全邊界內擴展能力。
前往章節提示組裝分層與行為控制,從系統提示到工具提示的完整路徑。
前往章節事件觸發、自動執行、驗證與保護,建立可重複的工作流程。
前往章節CLI 介面渲染引擎、輸入互動、視覺更新與終端限制下的設計取捨。
前往章節用 `src/` feature gate 與條件載入信號追蹤可能尚未全面開放的能力。
前往章節如果你已經知道自己遇到的問題類型,可以直接用這張表定位應該先讀哪一章。
| 你現在卡住的問題 | 先讀章節 | 再讀章節 | 典型收穫 |
|---|---|---|---|
| CLI 參數進來後不知道去哪裡 | 啟動流程 | 回合引擎 | 看懂輸入如何進入完整生命週期 |
| 不知道 command 為什麼會觸發某個 tool | 指令系統 | 工具系統 | 掌握解析、分派與工具契約邊界 |
| 工具執行常被權限模式擋下 | 模式與權限 | 狀態與任務 | 釐清允許條件與狀態切換時機 |
| 對話品質不穩定,提示行為飄移 | 提示系統 | 記憶系統 | 理解提示組裝與記憶載入交互影響 |
| 想把流程自動化,但怕破壞安全邊界 | Hooks 與自動化 | 代理與擴充 | 建立可控的擴充策略與防護點 |
這是一個可直接執行的最小學習計畫,適合想在一週內建立穩定心智模型的讀者。