AI 工具實測

Claude Skill、Plugin、Task 到底差在哪?一次實測搞懂 Claude 生態架構

艾沃克數位行銷 ·

Claude Skill、Plugin、Task 到底差在哪?一次實測搞懂 Claude 生態架構

為什麼我的 Skill 在這裡失效了?

上週在 Cowork 工具箱裡的「艾沃克文案引擎 skill」任務中打 #blog,原本預期會觸發預先設定好的部落格文案流程,結果 Claude 自己在本地建了一個 blog-ideas.md 檔案,完全沒走我設定的邏輯。

這不是 AI 不夠聰明,而是我根本搞錯了 Skill 的作用範圍。追查後發現:那個任務是一個獨立的 Cowork Task,有自己的沙箱化工作區(存在 local-agent-mode-sessions 底下的獨立資料夾),各自有 outputs/uploads 資料夾。它根本讀不到專案層級的 Skill 檔案。

而我現在這個對話,確認後其實是一個真正的 Claude Code Session(根目錄在 /Users/chris/Desktop/projects,transcript 存在 ~/.claude/projects/ 下),跟 Cowork 的 Local-Agent-Mode Task 是完全不同的儲存體系。

先講結論:Plugin 才是「隨處可用」的共享單位

如果你想讓某個 AI 助理行為(比如「打 #blog 就觸發文案引擎」)能在所有 Task、Chat、Cowork、Code 生效,你需要的不是 Skill 檔案,而是把它包裝成 Cowork Plugin

Plugin 是帳號/工具箱層級的共享單位,安裝後才能跨所有 Session 生效。Skill 只是檔案,需要被所在 Session 讀得到才會觸發。

這個認知差異直接決定了你的 AI 助理架構是「每次都要重新教」,還是「一次設定到處可用」。

Claude 生態裡的五個核心名詞

Session(對話階段)

最基本的單位,就是你跟 Claude 的一次連續對話。可能是 Chat 模式的純文字交流,也可能是 Code 模式裡有檔案存取權限的對話。

每個 Session 有自己的上下文記憶,但關掉就消失(除非你主動儲存成 Project)。這就是為什麼有時候你覺得「Claude 明明記得上次的設定」,換個視窗就忘光光。

Project(專案)

把 Session 的上下文、設定、檔案結構打包起來,變成可以重複開啟的工作環境。在 Claude Code 裡,Project 會存在 ~/.claude/projects/ 底下,包含 transcript(對話紀錄)和相關檔案。

如果你在某個 Project 裡放了 Skill 檔案(比如 .claude-skills/blog-capture/SKILL.md),那這個 Skill 只在這個 Project 的 Session 裡生效。

Cowork Task(Cowork 任務)

這是 Cowork 模式特有的概念,每個 Task 都是一個獨立的沙箱化工作區,存在 local-agent-mode-sessions 底下。

它有自己的 outputs/uploads/ 資料夾,跟其他 Task 或 Project 完全隔離。這就是為什麼我在「艾沃克文案引擎 skill」這個 Task 裡打 #blog 沒反應——它根本看不到我在別的專案裡設定的 Skill。

Skill(技能檔案)

本質上是一個 Markdown 檔案(通常命名為 SKILL.md),裡面寫了一組指令邏輯、觸發關鍵字、預設行為。

Skill 不會自動「全域生效」,它只是檔案。必須被當前 Session 或 Task 的工作目錄讀取到,才會被 Claude 解析並執行。

這就是為什麼「我明明有寫 Skill,為什麼這裡沒觸發」——因為你在不同的儲存體系裡,Claude 根本沒看到那份檔案。

Plugin(插件)

把 Skill 和相關設定打包成一個 zip 檔案,內含 .claude-plugin/plugin.jsonskills/*/SKILL.md,安裝到 Cowork 工具箱後,就能在帳號層級共享。

這才是「一次設定、到處可用」的正確做法。安裝 Plugin 後,無論你在哪個 Task、Chat、Cowork、Code Session,都能觸發同一組行為。

實測案例:為什麼 #blog 在這裡有效、那裡無效?

我原本有一個「blog-capture」Skill,放在某個 Claude Code Project 裡。在那個 Project 的 Session 中打 #blog,一切正常。

但當我在 Cowork 工具箱裡開了一個新的「艾沃克文案引擎 skill」Task,打 #blog 卻沒反應,Claude 反而自己建了一個 blog-ideas.md 檔案。

原因:那個 Task 的工作目錄是 local-agent-mode-sessions/艾沃克文案引擎-skill/,裡面沒有 .claude-skills/blog-capture/SKILL.md 這個檔案。Claude 讀不到,自然不知道 #blog 該觸發什麼行為。

解決方法:把 blog-capture 包裝成 Plugin(包含 .claude-plugin/plugin.json 和對應的 SKILL.md),安裝到 Cowork 工具箱。安裝後,所有 Task 和 Session 都能讀取到這個 Skill,#blog 才會在任何地方都有效。

什麼時候用 Skill、什麼時候打包成 Plugin?

如果這個 AI 助理行為只在單一專案裡需要(比如「這個客戶的品牌語氣設定」),直接把 Skill 檔案放在該 Project 的 .claude-skills/ 資料夾就好。

如果你希望這個行為能在所有工作環境裡重複使用(比如「部落格文案引擎」「SEO 檢查清單」),就應該打包成 Plugin,安裝到帳號層級。

我的經驗是:80% 的「我以為是通用的 Skill」其實都該做成 Plugin,否則你會一直遇到「明明有設定、為什麼這裡沒觸發」的困擾。

常見誤區與地雷

誤區一:以為 Skill 會自動同步
Skill 只是檔案,不會自動跨 Session 或 Task 同步。你在 A 專案裡寫的 Skill,B 專案看不到。

誤區二:在 Chat 模式裡期待 Skill 生效
Chat 模式沒有檔案存取權限,Claude 根本讀不到 SKILL.md。你需要在 Code 模式或 Cowork Task 裡才能觸發 Skill。

誤區三:把 Plugin 和 Skill 混為一談
Plugin 是「包含 Skill 的壓縮包 + 安裝機制」,Skill 只是「一份 Markdown 檔案」。前者是分發單位,後者是執行邏輯。

這套架構的限制

目前 Claude 的 Plugin 生態還沒有官方市集,你只能手動打包、手動安裝。如果你有 10 個常用 Skill,就得打包 10 次、安裝 10 次。

另外,Cowork Task 的沙箱隔離雖然安全,但也導致「明明安裝了 Plugin、為什麼這個 Task 還是讀不到」的困擾。實測發現有時需要重新啟動 Task 或重新載入工具箱,Plugin 才會生效。

這套架構還在快速演進,我預期半年後可能又會有新的名詞和機制出現。但掌握「Session 是對話層、Project 是專案層、Plugin 是帳號層」這個儲存邏輯,至少能讓你少走很多彎路。

下次你可以直接這樣做

如果你有一個常用的 AI 助理行為(比如「打 #seo 就自動檢查文案」),先在單一 Project 裡測試好 Skill 邏輯,確認觸發關鍵字和輸出格式都符合預期。

測試穩定後,請 Claude 幫你打包成 Plugin(包含 .claude-plugin/plugin.jsonskills/*/SKILL.md),安裝到 Cowork 工具箱。

安裝完成後,在不同的 Task 或 Session 裡實測一次,確認觸發行為一致。這樣你才算真正擁有一個「可攜式的 AI 助理模組」。

這篇是我實際排錯過程的紀錄,下次會展開成「如何打包你的第一個 Claude Plugin」教學文。如果你也在 Claude 生態裡遇到類似困擾,歡迎找我聊聊你的使用情境。

常見問題

我在 Chat 模式裡打 #blog 為什麼沒反應?

Chat 模式沒有檔案存取權限,Claude 讀不到 SKILL.md 檔案。你需要在 Code 模式或 Cowork Task 裡,並且確保該 Session 的工作目錄裡有對應的 Skill 檔案,或者已經安裝了包含該 Skill 的 Plugin。

我已經把 Skill 放在專案資料夾裡,為什麼還是沒觸發?

檢查兩件事:一是確認你現在的 Session 根目錄是否真的在那個專案資料夾(可以請 Claude 執行 pwd 確認);二是確認 Skill 檔案路徑是否正確(通常是 .claude-skills/skill-name/SKILL.md)。

如果你在 Cowork Task 裡,該 Task 的工作目錄是獨立的沙箱,跟你其他專案的資料夾完全隔離,這時候需要把 Skill 打包成 Plugin 才能跨 Task 使用。

Plugin 和 Skill 哪個比較好用?

這不是二選一的問題。Skill 是執行邏輯(一份 Markdown 檔案),Plugin 是分發機制(把 Skill 打包成可安裝的模組)。

如果你的 AI 助理行為只在單一專案裡需要,直接用 Skill 檔案就好;如果你希望在所有工作環境裡都能觸發同一組行為,就應該把 Skill 打包成 Plugin 安裝到帳號層級。大多數「我以為只用一次、結果一直重複用」的情境,最後都該做成 Plugin。

如果覺得內容有幫助,歡迎點讚或分享,讓艾工頭(的 AI 員工)更賣力分享喔!

分享出去

留言(0

留言會先經過人工審核,通過後才會公開顯示。