循循 synsoon 課程
03 / 7

設定檔階層與路徑限定

【改版】2026-09-28 新版:畫面全面改為逐格動畫,講到哪裡就標出哪裡,重點處畫面停留片刻;旁白改回原速。旁白講錯或與官方說法不符之處,畫面加上更正卡,並逐條列在下方【更正】。本片取代先前上架的舊版。 星期五晚上整頓完專案的程式碼風格,到了下週一,立刻爆發三個「靈異現象」。 這一集用三道官方公開的範例題把它拆開:專案規範該寫在哪裡、 專案指示與系統指令差在哪、動手之前該先計畫還是先行動, 以及設定檔階層與按路徑限定載入這兩個完全不同的維度——後者正課沒教,本集補足。 📚 正課對應 8:48 技能的層級分法 → 特講 Agent Skills〈擴散途徑與同名衝突〉 https://youtu.be/rePhxwc8XrE?t=839 14:51 三階段工作流 → ch7 Claude Code 終端機實戰〈先探查、再規劃、才實作〉 https://youtu.be/_2QLECQWhTg?t=917 20:36 設定檔的階層 → ch7〈記憶的四種作用範圍〉 https://youtu.be/_2QLECQWhTg?t=512 ;另見特講 CC in Action〈CLAUDE.md 為什麼不聽話〉 https://youtu.be/-gjRXdDT7Mk?t=225 20:41 按路徑限定載入——正課沒教,本集補足

本集章節12

本集心智圖5 組

規矩要放在會被自動撿起來的地方:階層、版控與路徑
  • 版控軸:放進專案全隊自動拿到,放家目錄只有你有
    • 團隊共用的斜線指令放專案內 .claude/commands/,跟程式碼一起進版控
    • 家目錄那份只屬於你這台機器,不進版控、不分享給隊友
    • CLAUDE.md 是專案指示與脈絡用的,不是拿來定義指令的
    • 「.claude/config.json 加 commands 陣列」這種機制不存在——考題常編出假設定檔
    • 先問這份東西要不要進版控,再決定它放哪
    • 新同事行為跟你不一樣,第一個要查的就是版控這條
  • 文件漂移:自訂指令已併入技能,但答案沒有變
    • 官方明寫自訂指令已併進技能:兩者產生同一個指令、行為一樣
    • 既有的 .claude/commands/ 舊檔繼續有效——不能說那題過時
    • 考試答 commands 那個選項;今天寫新的就寫成技能
    • 技能=把固定流程連同要用的檔案打包成資料夾
    • 「進專案 vs 放個人目錄」那條分層原則一個字都沒變
  • 規劃模式的判準:不是難度,是有沒有多條路都走得通
    • 該先規劃:大規模改動、多種都說得通的做法、架構決策、跨多檔
    • 該直接執行:範圍清楚、已經理解的改動——如有明確錯誤堆疊的單檔 bug
    • 規模是徵兆,決策才是病因——單檔 bug 也可能難,但通常只有一條路
    • 直接動手的代價是返工:依賴太晚發現,改到一半才知道邊界劃錯
    • 一開始就給超完整指示=假設沒讀程式碼就知道正確結構
    • 「遇到複雜再切規劃」是把已知當未知:題目一開始就講明要決定邊界
    • 可以組合:用規劃模式調查、定案之後直接執行去實作
  • 階層與路徑是兩個不同的軸
    • 設定檔三層:使用者層在家目錄、專案層在根目錄、目錄層在各子目錄
    • 階層管「誰的規矩、給誰用」;路徑樣式管「這條規矩什麼時候醒過來」
    • 目錄層綁位置:測試檔散在幾十個目錄,就得每個資料夾放一份
    • .claude/rules/ 規則檔開頭寫路徑樣式:綁檔案的形狀,不是位置
    • 全塞根目錄 CLAUDE.md 靠 AI 推論該套哪段——不可靠
    • 技能要嘛手動叫、要嘛靠 AI 決定,滿足不了「自動、按路徑」的要求
    • 附帶好處:路徑限定的規則只在動到符合的檔案時載入,省脈絡
  • 三個症狀的共同病灶:規矩寫在你「希望」它被讀到的地方
    • 三個症狀沒有一個是規矩寫得不清楚,全是放錯地方
    • 新同事行為不同——版控那條軸的問題
    • 同一人在不同資料夾行為不同、規矩時有時無——路徑那條軸的問題
    • 放置與規劃是同一件事的前後步:都在問「這件事該在什麼時候決定」
    • 行動:挑一個一直用「希望」在守的地方,把它換成確定的

本集更正1 字幕已更正影片加掛更正卡

  1. 19:41 旁白說技能「不能自動套用」——這是考試指南的說法,考試照它答;現行 Claude Code 文件(2026-08-18 快照)的技能可以設 paths,設了之後只在處理符合路徑的檔案時才自動載入。

    原本說不能自動套用 更正為這是考試指南的說法,考試照它答;現行 Claude Code 文件(2026-08-18 快照)的技能可以設 paths,設了之後只在處理符合路徑的檔案時才自動載入

    為什麼旁白說錯或說得比來源硬

    影片處置說明欄

    依據pages/exam/CCAR-F_exam_guide.txt L1388–L1389;pages/code/skills.md L339

另有 1 處措辭的精確化更正(把來源沒寫的形容詞、過度肯定的說法收回到文獻原本的範圍),不影響本集的結論。

改版說明

#ClaudeCode#CLAUDEmd#Claude#AI證照#認證考試