第 01 集 控制架構

Claude Code Deep Dive

控制架構總覽

先把 Claude Code 拆成五層,再談檔案、規則與團隊設計。這一集的目標不是列功能,而是建立一個可長期沿用的判斷框架。

時長 30:07
主軸 五層模型
形式 音檔 + 講義
產出 流程圖、心智圖、逐字稿

講義入口

圖像講義入口

這一頁把視覺講義、逐字稿與音訊放在同一個閱讀節奏裡。先看 flowchart 和 mind map,再回到文字和聲音。

流程圖

新需求如何落層

EP01 flowchart showing how a new requirement should be routed through control, automation, capability, collaboration, and write-back decisions.
先判斷它是政策、執行、能力還是協作,再決定檔案與機制。

把每個新需求先路由到對的層,再決定檔案與機制。

心智圖

五層控制架構

EP01 mind map showing the five-layer Claude Code control architecture.
把控制平面、自動化、能力、協作與 context 放在同一張圖上看。

用同一張腦圖理解政策、驗收、能力、分工與續航。

逐字稿

逐字稿與講義同步

如果你要回頭複習,直接讀逐字稿與講義版,不必在音訊裡倒帶找段落。

打開逐字稿

聲音試聽

Rain 聲音試聽

第一個連結是這輪剛跑完的 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 sample

Lecture 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 生成,這些都比較像能力問題。

協作平面和 Context 平面

協作平面真正要解的是責任切分。sub-agents 不是把所有上下文複製出去就好,而是要讓每個角色有清楚 ownership。Research 做定義,Architecture 做層級與檔案體系,Content 把它講成人能理解的東西,Instructor 穩住教學人格,Distribution 確保公開面一致。角色清楚,驗收才清楚。

Context 平面則是最容易被低估的一層。因為 thread 很長的時候,你會以為東西都還在,實際上 compact、注意力衰退、訊息噪音都會讓早期決策失真。所以真正重要的決策一定要寫回檔案。這不是文書習慣,是系統續航。

五個最常見反模式

  • 把 root file 寫成手冊。 這會讓最重要的規則反而最難被掃描。
  • 把提醒當 enforcement。 真正要擋的事情,如果沒有往 hooks 或 permissions 升級,就只是口頭規範。
  • 把技能和政策混在一起。 skill 不是治理本體,它是工作包。
  • 把 sub-agent 當責任外包。 spec 沒定義清楚,分再多 agent 都只會一起亂。
  • 把 context 當倉庫。 只留在對話裡的決策,最後一定會消失。

團隊實作時的最小判斷法

如果明天真的要重整一個亂掉的 repo,我會這樣做。先盤點現有 `CLAUDE.md`、settings、hooks、skills、subagents。接著先處理硬限制,不先碰漂亮不漂亮。危險操作要先分出來,重複工作要先找出來,然後才決定哪些要升成 hook、哪些要做成 skill、哪些只要留在控制平面。

最後一定要做的一件事,是把今天已經講清楚的決策寫回 repo。因為這套系統不是靠你今天懂一次就好,而是要讓別人明天接手、下週回來、甚至三個月後重看時,還能知道每一層在做什麼。

這集承諾

這一集要建立的是判斷框架

你不是在記更多名詞,而是在學會先分層,再分檔。這樣後面每一個新需求才知道該往哪個機制走。

一句話模型

Claude Code 不是功能清單

它是政策、驗收、能力、委派與 context 續航組成的分層系統。層級分對,規則就有位置;層級分錯,團隊就只會一直補洞。

真正改變

從「寫更多」切換成「放對地方」

這一集的目的不是把 root file 寫厚,而是讓 `CLAUDE.md`、settings、hooks、skills、subagents 各自做該做的事。

重點整理

三個重點

這三句是整集最適合拿來快速複習的結論。

01

先分層,再分檔

先判斷這是政策、執行、能力、分工還是 context 問題,再決定放哪個檔案。

02

文字不是 enforcement

需要硬限制的地方,應該往 permissions 或 hooks 升級,而不是只寫成提醒。

03

Context 不是倉庫

重要決策要寫回檔案,因為 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

單一 repo 的最小治理

小團隊要的是短 root file、少量高價值 hooks、少數高頻 skills,重點是先把責任放對,不要一開始就複雜化。

Monorepo

多團隊的邊界隔離

大 repo 需要 root 原則、nested 規則、排除清單與角色型 subagents,讓共享與隔離可以同時成立。

Closer

如果明天就要重整一個亂掉的 repo

第一週不要先追求全自動化。先把政策寫清楚,補上最重要的驗收,再把真正會重複的流程封裝起來。

這一集聽完後,你應該能很快判斷:哪個問題是政策、哪個是執行、哪個應該交給 hooks、哪個才值得做成 skill。