流程圖
新需求如何落層
把每個新需求先路由到對的層,再決定檔案與機制。
Claude Code Deep Dive
先把 Claude Code 拆成五層,再談檔案、規則與團隊設計。這一集的目標不是列功能,而是建立一個可長期沿用的判斷框架。
講義入口
這一頁把視覺講義、逐字稿與音訊放在同一個閱讀節奏裡。先看 flowchart 和 mind map,再回到文字和聲音。
流程圖
把每個新需求先路由到對的層,再決定檔案與機制。
心智圖
用同一張腦圖理解政策、驗收、能力、分工與續航。
逐字稿
如果你要回頭複習,直接讀逐字稿與講義版,不必在音訊裡倒帶找段落。
打開逐字稿音檔
音檔與講義使用同一套章節語言,方便在聽與讀之間切換。
收聽最新 fullmix-v2 整集 preview 收聽目前正式上架版聲音試聽
第一個連結是這輪剛跑完的 fullmix-v2 整集 preview。它已經不是 5 分鐘 audition,而是整個 EP01 用工廠流程拼完的版本。下面保留 v14e、v14d、v14b 頭段 preview、v13c 完整版和前一輪版本,方便直接做對照。
試聽最新 fullmix-v2 整集 preview(24 分 52 秒) 試聽最新 v14e 延伸 preview(頭段 + 全中文 tail) 試聽 v14d 延伸 preview(頭段 + 修好的 tail) 試聽 v14b 頭段 preview(新 reference + 新咬字/換氣規則) 試聽最新 v13c 修正版(壞段補錄後的完整 audition) 試聽 v13b 整支版(前一版完整 audition) 試聽最新 v13b 頭段 preview(新 hard gate + 新 scoring) 試聽最新 v12f best-of-N 版(較少重複、較少接縫怪聲) 試聽 v12e neutral reference 版(作為 reference 對照) 試聽 v12b 邊界修正版(上一輪基線) 上一版 v12a 穩定化版(style profile + 發音詞典 + 分段渲染) 試聽最新 v10a 分段版(更少雜音、少重複、比較有力) 上一版 v9b 連句版(對照) 上一版 v8 語氣版(對照) 上一版 v7b 輕稿版(對照) 上一版 v6 順句版(對照) 上一版 v5 斷句版(對照) 上一版 v4 清楚版(對照) 前一版 GPT-SoVITS e1 對照 試聽 5 分鐘 clean 版 試聽 5 分鐘 raw 版 舊版 1 分鐘對照 sample 舊版 market reference sampleLecture Note
這裡開始才是 podcast 應該打出去的講義正文,不是節目殼,不是摘要頁。
很多團隊不是工具不夠用,而是把不同層的東西全塞在一起。有人把長期政策寫成聊天提醒,有人把真正該阻擋的危險操作留在口頭規則,有人又把重複流程一直留在人工步驟。最後看起來像是 Claude Code 很亂,其實亂的是層級。
所以這一集最重要的不是介紹功能清單,而是先建立一個判斷框架。你之後看到任何一個需求,都先問自己:這是政策問題、執行問題、能力問題、協作問題,還是 context 續航問題。問題分對層,解法才會落對地方。
Claude Code 可以拆成五層:控制平面負責政策與路由,自動化平面負責可執行的 guardrail,能力平面負責可重用工作包,協作平面負責責任切分,Context 平面負責工作記憶與續航。
這五層不是功能分類遊戲,而是團隊治理模型。因為你真正要管理的不是單一 prompt,而是整個系統到底怎麼被讀取、怎麼被執行、誰來負責、出了錯怎麼被擋下來,以及會話結束之後還能不能接得回去。
控制平面的工作是定方向。像 `CLAUDE.md`、rules、settings、permissions 這些東西,最適合放在這一層。它負責回答「我們這個 repo 的原則是什麼」、「哪些事應該被限制」、「哪些設定是共享底線」。但你要記住,它能定方向,不代表它能保證每一個細節一定被執行。
這也是很多人第一個會搞錯的地方。把一段話寫進 `CLAUDE.md`,不等於它自然就變成 enforcement。如果某件事真的需要被擋下來,那你就不該停在文字層。
自動化平面講的是 hooks 這種可執行 guardrail。它的價值在於確定性。比如危險指令要在執行前攔下來,收尾時一定要驗收,這種事情放在 hooks 才有意義。你不能期待一句提醒文字在壓力大的時候還永遠會被遵守。
能力平面則是另一回事。skills、plugins、MCP 比較像可重用工作包。它們不是拿來定政策,也不是拿來當安全底線,而是把高頻、重複、可以封裝的工作收起來。像研究來源初步分級、稿件人話化、發佈前 metadata 生成,這些都比較像能力問題。
協作平面真正要解的是責任切分。sub-agents 不是把所有上下文複製出去就好,而是要讓每個角色有清楚 ownership。Research 做定義,Architecture 做層級與檔案體系,Content 把它講成人能理解的東西,Instructor 穩住教學人格,Distribution 確保公開面一致。角色清楚,驗收才清楚。
Context 平面則是最容易被低估的一層。因為 thread 很長的時候,你會以為東西都還在,實際上 compact、注意力衰退、訊息噪音都會讓早期決策失真。所以真正重要的決策一定要寫回檔案。這不是文書習慣,是系統續航。
如果明天真的要重整一個亂掉的 repo,我會這樣做。先盤點現有 `CLAUDE.md`、settings、hooks、skills、subagents。接著先處理硬限制,不先碰漂亮不漂亮。危險操作要先分出來,重複工作要先找出來,然後才決定哪些要升成 hook、哪些要做成 skill、哪些只要留在控制平面。
最後一定要做的一件事,是把今天已經講清楚的決策寫回 repo。因為這套系統不是靠你今天懂一次就好,而是要讓別人明天接手、下週回來、甚至三個月後重看時,還能知道每一層在做什麼。
這集承諾
你不是在記更多名詞,而是在學會先分層,再分檔。這樣後面每一個新需求才知道該往哪個機制走。
一句話模型
它是政策、驗收、能力、委派與 context 續航組成的分層系統。層級分對,規則就有位置;層級分錯,團隊就只會一直補洞。
真正改變
這一集的目的不是把 root file 寫厚,而是讓 `CLAUDE.md`、settings、hooks、skills、subagents 各自做該做的事。
重點整理
這三句是整集最適合拿來快速複習的結論。
先判斷這是政策、執行、能力、分工還是 context 問題,再決定放哪個檔案。
需要硬限制的地方,應該往 permissions 或 hooks 升級,而不是只寫成提醒。
重要決策要寫回檔案,因為 thread 會斷、compact 會發生,人也會換。
Boundaries
這段的重點是邊界,不是功能表。每層都有用,但每層也都有做不到的事。
能定方向,不能保證行為。適合放長期政策,不適合放完整 SOP。
能攔下來、驗下來,但不適合承擔模糊判斷或架構決策。
能封裝重複流程,但不是安全邊界,也不是治理本體。
能切責任,但救不了模糊 spec。分工之前先定義交付。
Minimum Viable Template
這不是完整 repo 示意,而是讓這個節目之後能一直複製的底座。
ai-edu-media/
CLAUDE.md
.claude/
rules/
agents/
skills/
research/
architecture/
content/episodes/ep01/
podcast/
distribution/
website/
Why It Matters
如果你直接看工具,會一直加東西;如果你先看層級,就會知道該把東西放哪裡。
Small Team
小團隊要的是短 root file、少量高價值 hooks、少數高頻 skills,重點是先把責任放對,不要一開始就複雜化。
Monorepo
大 repo 需要 root 原則、nested 規則、排除清單與角色型 subagents,讓共享與隔離可以同時成立。
Closer
第一週不要先追求全自動化。先把政策寫清楚,補上最重要的驗收,再把真正會重複的流程封裝起來。