Cherry Studio Skills Manager 實戰指南Claude Code Agent Skills 的搜索、安裝與創建管理【免費下載鏈接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs項目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio本文以 Cherry Studio 內置 Cherry Assistant 中的skills-manager技能SKILL.md為骨架完整拆解其搜索—安裝—創建—驗證四步閉環優先復用內置工具搜索安裝第三方 Skill缺失時降級到 CLI需要新能力時移交 skill-creator 創建自定義 Skill。讀完本文你將掌握在 Cherry Studio 中安全引入外部 Agent Skills、規范創建自有 Skill 的完整方法并理解底層 SkillService 的存儲、鏡像與白名單機制。一、Skills Manager 在 Cherry Studio 中的定位Cherry Studio 內置的 Cherry Assistant 通過一組.claude/skills/技能目錄來組織 Agent 能力。其中skills-manager是一個元技能——它的職責不是完成某個具體業務任務而是協調其他技能與工具完成 Skill 的搜索、安裝和創建。其 frontmatter 中的觸發條件非常寬泛用戶說find a skill搜索技能幫我做個 skillcreate a skill用戶說有沒有做 X 的工具我想擴展 Agent 能力當前能力不足需要先查找可復用方案的場景可以看到Skills Manager 是 Agent 面對能力缺口時的統一入口它決定了 Agent 是去市場上找現成技能、直接用 CLI 安裝還是調用 skill-creator 現場創作。從倉庫源碼結構看與它協作的還有兩個同層技能cherry-skill-marketplace面向 MCP 工具mcp__skills__search_skills/mcp__skills__install_skill的市場路由負責搜索、安裝以及引導用戶在 Skills UI 中管理已安裝技能find-skills聲明了search_skills(query)與install_skill(install_source)兩個內置工具的實現語義。二者可推斷為 Skills Manager 文檔中優先復用 find-skills所指的實際落地對象而skill-creatorSKILL.md則是創建自定義 Skill流程的專屬執行者。二、搜索與安裝兩級執行路徑Skills Manager 對搜索和安裝定義了清晰的兩級優先級先復用內置搜索工具再降級到 CLI。1. 優先復用 find-skills主路徑文檔明確要求find-skills可用時先調用它完成搜索、質量檢查和安裝確認只有不可用時才執行下面的 CLI 降級流程。對應到 find-skills 的實現其執行鏈路如下搜索調用內置工具search_skills(query)按關鍵詞檢索技能市場返回匹配結果及不透明的install_source值安裝調用內置工具install_skill(install_source)Cherry 會克隆倉庫、僅安裝這一個技能到托管庫并在單一確定性步驟中完成注冊。文檔特別強調不要用npx skills add、git clone等 shell 命令替代因為那會安裝整個倉庫數十個技能、向其他工具散布符號鏈接且落在 Cherry 管理庫之外權限安裝動作受當前 Claude 權限模式約束default / accept-edits 模式可能經 SDK 彈窗確認bypass-permissions 模式直接執行。2. CLI 降級流程備選路徑當內置工具不可用時Skills Manager 按順序嘗試以下運行時優先npx skills備選$CHERRY_STUDIO_BUN_PATH x skills兩者都沒有則提示用戶安裝 Node.js搜索的標準動作是理解需求 → 提取關鍵詞 → 執行npx skills find [query]→ 向用戶展示技能的名稱、功能與來源。安裝的標準動作遵循嚴格的四步安全流程展示安全警告 → 提供源碼鏈接 → 用戶確認 → npx skills add owner/reposkill -y其中的-y參數用于跳過交互確認。安裝位置有兩類項目級.claude/skills/跟隨項目、隨倉庫分發用戶級~/.claude/skills/全局可用、跨項目生效3. 搜索無結果時的處理文檔給出了明確的兜底順序告知用戶沒有找到現成 Skill先嘗試用 Agent 自身通用能力直接完成任務如果這是可復用的流程再建議創建自定義 Skill。這與 find-skills 的沒有結果段落完全一致承認未找到 → 直接提供幫助 → 提議為重復性任務創作自定義技能由 skill-creator 處理。三、安裝安全第三方代碼的邊界管理Skills Manager 將安全提示放在安裝動作的最前端這是整個流程中不可省略的環節Skills 是第三方代碼擁有完整權限。一個惡意的 Skill 可以讀取、修改甚至刪除用戶系統上的文件——這一點在 find-skills 中同樣被顯著標注安裝前必須展示安全警告說明該技能是第三方代碼將以完整 Agent 權限運行必須提供源碼鏈接讓用戶能審閱該技能的SKILL.md及其包含的腳本必須取得用戶明確確認后才執行安裝命令。換言之Skills Manager 刻意把信任決策保留給人類用戶Agent 只負責把風險和審查入口透明化。從源碼層面看這份警惕同樣體現在 SkillService 的工程實現中安裝過程封裝在 SkillService.ts 的SkillInstaller中并配有mutationLockMutex將所有庫變更安裝/卸載/內置同步/對賬串行化防止并發讀取到中間態技能安裝后并不直接暴露給運行時而是按會話下發名稱白名單buildSkillWhitelist鏡像目錄在會話構建期不會被隨意改動。四、創建 Skills先復用、再創作、必須驗證Skills Manager 對創建的要求比搜索安裝更嚴格因為它直接決定新增能力是否會被正確觸發與執行。步驟 1確認值得創建文檔要求先回答兩個問題現有 Skill 是否確實無法滿足需求這是不是值得復用的流程如果只是一次性任務直接完成即可不強行創建 Skill——避免為單次使用引入永久維護負擔。步驟 2優先調用 skill-creator檢查可用技能列表skill-creator可用時必須調用它并完整遵循其需求澄清、初始化、編輯、驗證和迭代流程不要繞過它直接手寫SKILL.md。skill-creatorSKILL.md提供了遠超寫一個文件的完整工程化流程需求澄清捕獲用戶意圖——技能應讓 Agent 能做什么、何時觸發、期望的輸出格式、是否需要測試用例初始化在$CHERRY_STUDIO_SKILLS_DIRCherry 的托管技能庫下創建目錄與SKILL.md文件夾名與 frontmattername必須一致且僅使用小寫字母、數字與連字符如my-cool-skill編輯遵循漸進式披露結構——元數據name description常駐上下文、SKILL.md正文在觸發時加載理想 500 行、scripts/references/assets/按需加載驗證與迭代編寫 2-3 個真實測試提示詞同時啟動帶技能與基線兩個子代理跑分用scripts.aggregate_benchmark聚合、eval-viewer/generate_review.py生成審查頁依據用戶反饋迭代改進描述優化生成 20 條應觸發/不應觸發的評測查詢用scripts.run_loop自動迭代 description防止技能欠觸發。步驟 3CLI 降級初始化僅當skill-creator確實不可用時才明確告訴用戶正在降級然后執行npx skills init skill-name初始化后保持SKILL.md精簡并按需加入三類支持資源目錄用途加載時機scripts/可執行代碼用于確定性/重復性任務執行時按需加載references/文檔作為上下文按需引入需要時加載assets/輸出用文件模板、圖標、字體生成產物時使用關于 SKILL.md 的最小結構與 frontmatter 字段可參考 claude-automation-recommender 的 skills-reference其中給出了disable-model-invocation、user-invocable、allowed-tools、context、agent等字段的取值與用戶/Claude 誰能觸發的對應關系以及$ARGUMENTS參數模式和!command 動態上下文注入等進階寫法。步驟 4創建后必須驗證創建完成后至少驗證三件事驗證失敗就修正后重跑frontmatter是否合法name與description字段是否齊全、命名是否符合規范觸發描述是否準確覆蓋目標場景description 是 Skill 最主要的觸發機制一個真實用例是否跑通。從代碼層面看倉庫確實為 Skill 元數據解析提供了支撐markdownParser 中的parseSkillMetadata、findSkillMdPath、findAllSkillDirectories被 SkillService.ts 用于讀取每個技能目錄的元數據——這就是驗證 frontmatter的底層實現。五、與 Cherry Skill Marketplace 的分工Skills Manager 與同層技能 cherry-skill-marketplace 在職責上互補而不重疊能力環節skills-managercherry-skill-marketplace觸發時機搜索/安裝/創建 Skill 的通用意圖明確要求搜索、安裝、查看、卸載、創建 Skill或內置能力出現缺口搜索優先find-skills降級npx skills findmcp__skills__search_skills安裝確認后npx skills addCLI 降級路徑確認后mcp__skills__install_skill查看/卸載—通過mcp__assistant__product_info讀取 manifest 路由導航到 Skills UI 完成創建移交skill-creator移交內置skill-creator不重復實現失敗處理告知無結果 → 直接完成 → 建議創建能力缺口必須立即補足不得只回復 unsupported二者共享同一條安全底線第三方 Skill 安裝前必須取得用戶明確同意、說明其將繼承當前工具權限且不向第三方發送憑據、附件內容或本地路徑。marketplace 技能還額外強調工具錯誤原樣概括不把失敗說成成功也不偷偷切換到 npx 或全局安裝。六、底層機制Skill 如何被存儲與生效Skills Manager 的指令最終都落到 Cherry Studio 的 Skill 管理服務上。從 SkillService.ts 的類注釋可以看到完整的存儲模型規范庫技能存儲在{dataPath}/Skills/{folderName}/這是應用擁有的權威技能庫鏡像機制安裝/卸載/啟動對賬linkMirror/reconcileSkills時技能會被鏡像到CLAUDE_CONFIG_DIR/skills供 Claude Agent SDK 發現白名單隔離每個會話只把名稱白名單buildSkillWhitelist下發給 SDK鏡像目錄在會話構建期不會被改動——這既保證能力可見又避免會話期間的意外篡改兩級元數據技能庫級元數據存于agent_global_skill表每個 Agent 的啟用狀態存于agent_skill關聯表schema 見 agentSkill.ts變更串行化所有庫變更通過mutationLockMutex串行執行并對啟動時的并發對賬做去重reconcileInFlight。這意味著無論通過內置工具、CLI 還是手工寫入$CHERRY_STUDIO_SKILLS_DIR創建技能最終都會進入同一個托管庫并統一經歷鏡像與注冊——這也是創建后無需額外注冊步驟skill-creator 中明確說明的根本原因。七、最佳實踐小結基于以上完整流程在實際使用中建議遵循以下原則搜索優先創建兜底先search_skills/npx skills find找現成技能無結果且任務可復用時才創建自定義 Skill安裝必過安全三關展示第三方代碼風險 → 提供源碼鏈接 → 獲得用戶確認缺一不可創建必走 skill-creator不繞過它手寫 SKILL.md創建后至少驗證 frontmatter、觸發描述與一個真實用例注意運行時差異內置工具可用時絕不降級到npx/git安裝避免整個倉庫被引入并散落到 Cherry 管理庫之外區分任務與能力一次性任務直接完成不要強行造 Skill只有值得復用的流程才值得固化為技能。通過這套搜索—安裝—創建—驗證閉環Cherry Studio 的 Cherry Assistant 可以在保持安全邊界的前提下持續從開放技能生態中補充能力或為用戶的重復性工作沉淀自有技能——這正是 Skills Manager 作為元技能的核心價值所在。【免費下載鏈接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs項目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 Cherry Studio Skills Manager 實戰指南：Claude Code Agent Skills 的搜索、安裝與創建管理
Cherry Studio Skills Manager 實戰指南Claude Code Agent Skills 的搜索、安裝與創建管理【免費下載鏈接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs項目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio本文以 Cherry Studio 內置 Cherry Assistant 中的skills-manager技能SKILL.md為骨架完整拆解其搜索—安裝—創建—驗證四步閉環優先復用內置工具搜索安裝第三方 Skill缺失時降級到 CLI需要新能力時移交 skill-creator 創建自定義 Skill。讀完本文你將掌握在 Cherry Studio 中安全引入外部 Agent Skills、規范創建自有 Skill 的完整方法并理解底層 SkillService 的存儲、鏡像與白名單機制。一、Skills Manager 在 Cherry Studio 中的定位Cherry Studio 內置的 Cherry Assistant 通過一組.claude/skills/技能目錄來組織 Agent 能力。其中skills-manager是一個元技能——它的職責不是完成某個具體業務任務而是協調其他技能與工具完成 Skill 的搜索、安裝和創建。其 frontmatter 中的觸發條件非常寬泛用戶說find a skill搜索技能幫我做個 skillcreate a skill用戶說有沒有做 X 的工具我想擴展 Agent 能力當前能力不足需要先查找可復用方案的場景可以看到Skills Manager 是 Agent 面對能力缺口時的統一入口它決定了 Agent 是去市場上找現成技能、直接用 CLI 安裝還是調用 skill-creator 現場創作。從倉庫源碼結構看與它協作的還有兩個同層技能cherry-skill-marketplace面向 MCP 工具mcp__skills__search_skills/mcp__skills__install_skill的市場路由負責搜索、安裝以及引導用戶在 Skills UI 中管理已安裝技能find-skills聲明了search_skills(query)與install_skill(install_source)兩個內置工具的實現語義。二者可推斷為 Skills Manager 文檔中優先復用 find-skills所指的實際落地對象而skill-creatorSKILL.md則是創建自定義 Skill流程的專屬執行者。二、搜索與安裝兩級執行路徑Skills Manager 對搜索和安裝定義了清晰的兩級優先級先復用內置搜索工具再降級到 CLI。1. 優先復用 find-skills主路徑文檔明確要求find-skills可用時先調用它完成搜索、質量檢查和安裝確認只有不可用時才執行下面的 CLI 降級流程。對應到 find-skills 的實現其執行鏈路如下搜索調用內置工具search_skills(query)按關鍵詞檢索技能市場返回匹配結果及不透明的install_source值安裝調用內置工具install_skill(install_source)Cherry 會克隆倉庫、僅安裝這一個技能到托管庫并在單一確定性步驟中完成注冊。文檔特別強調不要用npx skills add、git clone等 shell 命令替代因為那會安裝整個倉庫數十個技能、向其他工具散布符號鏈接且落在 Cherry 管理庫之外權限安裝動作受當前 Claude 權限模式約束default / accept-edits 模式可能經 SDK 彈窗確認bypass-permissions 模式直接執行。2. CLI 降級流程備選路徑當內置工具不可用時Skills Manager 按順序嘗試以下運行時優先npx skills備選$CHERRY_STUDIO_BUN_PATH x skills兩者都沒有則提示用戶安裝 Node.js搜索的標準動作是理解需求 → 提取關鍵詞 → 執行npx skills find [query]→ 向用戶展示技能的名稱、功能與來源。安裝的標準動作遵循嚴格的四步安全流程展示安全警告 → 提供源碼鏈接 → 用戶確認 → npx skills add owner/reposkill -y其中的-y參數用于跳過交互確認。安裝位置有兩類項目級.claude/skills/跟隨項目、隨倉庫分發用戶級~/.claude/skills/全局可用、跨項目生效3. 搜索無結果時的處理文檔給出了明確的兜底順序告知用戶沒有找到現成 Skill先嘗試用 Agent 自身通用能力直接完成任務如果這是可復用的流程再建議創建自定義 Skill。這與 find-skills 的沒有結果段落完全一致承認未找到 → 直接提供幫助 → 提議為重復性任務創作自定義技能由 skill-creator 處理。三、安裝安全第三方代碼的邊界管理Skills Manager 將安全提示放在安裝動作的最前端這是整個流程中不可省略的環節Skills 是第三方代碼擁有完整權限。一個惡意的 Skill 可以讀取、修改甚至刪除用戶系統上的文件——這一點在 find-skills 中同樣被顯著標注安裝前必須展示安全警告說明該技能是第三方代碼將以完整 Agent 權限運行必須提供源碼鏈接讓用戶能審閱該技能的SKILL.md及其包含的腳本必須取得用戶明確確認后才執行安裝命令。換言之Skills Manager 刻意把信任決策保留給人類用戶Agent 只負責把風險和審查入口透明化。從源碼層面看這份警惕同樣體現在 SkillService 的工程實現中安裝過程封裝在 SkillService.ts 的SkillInstaller中并配有mutationLockMutex將所有庫變更安裝/卸載/內置同步/對賬串行化防止并發讀取到中間態技能安裝后并不直接暴露給運行時而是按會話下發名稱白名單buildSkillWhitelist鏡像目錄在會話構建期不會被隨意改動。四、創建 Skills先復用、再創作、必須驗證Skills Manager 對創建的要求比搜索安裝更嚴格因為它直接決定新增能力是否會被正確觸發與執行。步驟 1確認值得創建文檔要求先回答兩個問題現有 Skill 是否確實無法滿足需求這是不是值得復用的流程如果只是一次性任務直接完成即可不強行創建 Skill——避免為單次使用引入永久維護負擔。步驟 2優先調用 skill-creator檢查可用技能列表skill-creator可用時必須調用它并完整遵循其需求澄清、初始化、編輯、驗證和迭代流程不要繞過它直接手寫SKILL.md。skill-creatorSKILL.md提供了遠超寫一個文件的完整工程化流程需求澄清捕獲用戶意圖——技能應讓 Agent 能做什么、何時觸發、期望的輸出格式、是否需要測試用例初始化在$CHERRY_STUDIO_SKILLS_DIRCherry 的托管技能庫下創建目錄與SKILL.md文件夾名與 frontmattername必須一致且僅使用小寫字母、數字與連字符如my-cool-skill編輯遵循漸進式披露結構——元數據name description常駐上下文、SKILL.md正文在觸發時加載理想 500 行、scripts/references/assets/按需加載驗證與迭代編寫 2-3 個真實測試提示詞同時啟動帶技能與基線兩個子代理跑分用scripts.aggregate_benchmark聚合、eval-viewer/generate_review.py生成審查頁依據用戶反饋迭代改進描述優化生成 20 條應觸發/不應觸發的評測查詢用scripts.run_loop自動迭代 description防止技能欠觸發。步驟 3CLI 降級初始化僅當skill-creator確實不可用時才明確告訴用戶正在降級然后執行npx skills init skill-name初始化后保持SKILL.md精簡并按需加入三類支持資源目錄用途加載時機scripts/可執行代碼用于確定性/重復性任務執行時按需加載references/文檔作為上下文按需引入需要時加載assets/輸出用文件模板、圖標、字體生成產物時使用關于 SKILL.md 的最小結構與 frontmatter 字段可參考 claude-automation-recommender 的 skills-reference其中給出了disable-model-invocation、user-invocable、allowed-tools、context、agent等字段的取值與用戶/Claude 誰能觸發的對應關系以及$ARGUMENTS參數模式和!command 動態上下文注入等進階寫法。步驟 4創建后必須驗證創建完成后至少驗證三件事驗證失敗就修正后重跑frontmatter是否合法name與description字段是否齊全、命名是否符合規范觸發描述是否準確覆蓋目標場景description 是 Skill 最主要的觸發機制一個真實用例是否跑通。從代碼層面看倉庫確實為 Skill 元數據解析提供了支撐markdownParser 中的parseSkillMetadata、findSkillMdPath、findAllSkillDirectories被 SkillService.ts 用于讀取每個技能目錄的元數據——這就是驗證 frontmatter的底層實現。五、與 Cherry Skill Marketplace 的分工Skills Manager 與同層技能 cherry-skill-marketplace 在職責上互補而不重疊能力環節skills-managercherry-skill-marketplace觸發時機搜索/安裝/創建 Skill 的通用意圖明確要求搜索、安裝、查看、卸載、創建 Skill或內置能力出現缺口搜索優先find-skills降級npx skills findmcp__skills__search_skills安裝確認后npx skills addCLI 降級路徑確認后mcp__skills__install_skill查看/卸載—通過mcp__assistant__product_info讀取 manifest 路由導航到 Skills UI 完成創建移交skill-creator移交內置skill-creator不重復實現失敗處理告知無結果 → 直接完成 → 建議創建能力缺口必須立即補足不得只回復 unsupported二者共享同一條安全底線第三方 Skill 安裝前必須取得用戶明確同意、說明其將繼承當前工具權限且不向第三方發送憑據、附件內容或本地路徑。marketplace 技能還額外強調工具錯誤原樣概括不把失敗說成成功也不偷偷切換到 npx 或全局安裝。六、底層機制Skill 如何被存儲與生效Skills Manager 的指令最終都落到 Cherry Studio 的 Skill 管理服務上。從 SkillService.ts 的類注釋可以看到完整的存儲模型規范庫技能存儲在{dataPath}/Skills/{folderName}/這是應用擁有的權威技能庫鏡像機制安裝/卸載/啟動對賬linkMirror/reconcileSkills時技能會被鏡像到CLAUDE_CONFIG_DIR/skills供 Claude Agent SDK 發現白名單隔離每個會話只把名稱白名單buildSkillWhitelist下發給 SDK鏡像目錄在會話構建期不會被改動——這既保證能力可見又避免會話期間的意外篡改兩級元數據技能庫級元數據存于agent_global_skill表每個 Agent 的啟用狀態存于agent_skill關聯表schema 見 agentSkill.ts變更串行化所有庫變更通過mutationLockMutex串行執行并對啟動時的并發對賬做去重reconcileInFlight。這意味著無論通過內置工具、CLI 還是手工寫入$CHERRY_STUDIO_SKILLS_DIR創建技能最終都會進入同一個托管庫并統一經歷鏡像與注冊——這也是創建后無需額外注冊步驟skill-creator 中明確說明的根本原因。七、最佳實踐小結基于以上完整流程在實際使用中建議遵循以下原則搜索優先創建兜底先search_skills/npx skills find找現成技能無結果且任務可復用時才創建自定義 Skill安裝必過安全三關展示第三方代碼風險 → 提供源碼鏈接 → 獲得用戶確認缺一不可創建必走 skill-creator不繞過它手寫 SKILL.md創建后至少驗證 frontmatter、觸發描述與一個真實用例注意運行時差異內置工具可用時絕不降級到npx/git安裝避免整個倉庫被引入并散落到 Cherry 管理庫之外區分任務與能力一次性任務直接完成不要強行造 Skill只有值得復用的流程才值得固化為技能。通過這套搜索—安裝—創建—驗證閉環Cherry Studio 的 Cherry Assistant 可以在保持安全邊界的前提下持續從開放技能生態中補充能力或為用戶的重復性工作沉淀自有技能——這正是 Skills Manager 作為元技能的核心價值所在。【免費下載鏈接】cherry-studioAI productivity studio with smart chat, autonomous agents, and 300 assistants. Unified access to frontier LLMs項目地址: https://gitcode.com/GitHub_Trending/ch/cherry-studio創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考