WorkBuddy 技能裝在哪:~/.workbuddy 目錄結構與備份解除安裝

釋出於 2026-11-16 · 獨立第三方評測 · 轉載請註明出處

直接回答:一個裝好的 WorkBuddy Skill,就是一個頂層帶 SKILL.md 的資料夾——官方市場一鍵安裝的由客戶端統一管理,社群匯入的則落在你使用者主目錄下的 .workbuddy 相關目錄裡。本文講清它的結構、位置和手動管理(備份/解除安裝/清理)的做法。路徑資訊基於公開社群資料與真實檢索訊號交叉印證,核實於 2026-11-16;不同客戶端版本可能調整,刪除或移動前請先備份,以你機器上的實際情況為準。

技能包長什麼樣

無論是官方市場還是社群倉庫,技能包的形態是一致的:一個資料夾,頂層必須有 SKILL.md(說明技能是什麼、何時觸發、怎麼執行),旁邊放指令碼和資原始檔。這是開放格式,也是你能用文本編輯器讀懂每一個技能的原因——寫法詳見 SKILL.md 製作流程。

公開市場歸檔倉庫 infometa/workbuddyskills 從 WorkBuddy/CodeBuddy 公開市場打包了 295 個技能包,全部是這種”頂層 SKILL.md”結構,可以離線翻看學習(僅作學習用途,注意其版權宣告)。

落盤位置

系統常見位置
macOS / Linux~/.workbuddy/(使用者主目錄下)
Windows%USERPROFILE%\.workbuddy\(如 C:\Users\你的使用者名稱\.workbuddy\)

目錄內的組織隨安裝方式不同:通過市場源自動同步的技能在 plugins/marketplaces/ 下的對應倉庫資料夾;手動匯入的則在技能目錄下單獨成資料夾。以你客戶端的實際版本為準——如果目錄結構和本文不一致,優先相信你機器上的,並在客戶端技能詳情裡核對來源。

三個常見場景

備份與遷移(換電腦):整個 .workbuddy 目錄拷到新機器同位置,重啟客戶端即可;官方市場安裝的那部分不用拷,登入後重裝更快。

手動解除安裝:官方市場安裝的在市場「已安裝」列表裡解除安裝;手動匯入的刪除對應技能資料夾後重啟生效,操作細節見安裝指南的解除安裝一節。

排查不生效:先看技能資料夾在不在、SKILL.md 是否完好,再按裝了不生效排查清單逐項核對;更細的故障現象(觸發錯亂、許可權拒絕)查故障字典。

GitHub 倉庫裡的 skills/ ≠ 本地目錄

搜尋 ~/.workbuddy/skills 的人,不少是被 GitHub 倉庫結構帶偏的:社群倉庫(如 bitcjm/workbuddy-skills)把幾十個技能按分類放在倉庫的 skills/ 目錄裡,那是倉庫自己的歸檔結構。從倉庫安裝時按它的 README 指引走——常見做法是對話方塊貼倉庫地址由 Agent 引導安裝,或配置為市場源自動同步;複製到本地的,始終是一個個技能資料夾,而不是整個倉庫。

清理與安全提醒

  1. 刪資料夾前先備份:技能目錄裡可能混著你改過的配置和多個來源的技能,批次刪除前整目錄打包一份
  2. 來歷不明的技能資料夾先讀後用:開啟 SKILL.md 和指令碼掃一眼,警惕要求讀取無關目錄、聯網上傳本地檔案的技能,完整避坑清單見技能下載攻略
  3. 別把 .workbuddy 當配置備份的唯一副本:換機、重灌前先整體備份,客戶端內的賬號資料(積分、會員)不在技能目錄裡

常見問題

WorkBuddy 技能資料夾可以直接改嗎?

技術上可以(SKILL.md 就是文本),但官方市場安裝的技能在更新時會被覆蓋,改動前先備份;改完重啟客戶端生效。

~/.workbuddy 目錄找不到怎麼辦?

先確認已安裝過技能;Windows 在 %USERPROFILE%\.workbuddy,macOS/Linux 在 ~/.workbuddy。仍找不到就在客戶端技能詳情裡檢視來源,以客戶端展示為準。

能跳過市場手動裝技能嗎?

可以,三種方式:對話指令安裝、配置為市場源自動同步、下載技能包複製到技能目錄後重啟,詳見安裝指南。

GitHub 倉庫裡的 skills/ 目錄是什麼?

那是倉庫自己的歸檔結構,不是客戶端落盤目錄;從倉庫安裝時按 README 指引走,複製的是一個個含 SKILL.md 的技能資料夾。