前言¶

在 SkillHub 或 WorkBuddy 裏裝了不少 Skill 之後，常見問題是：不知道哪個 Skill 適合當前任務、安裝路徑不對導致 Agent 讀不到、版本散落難以升級，組合多個 Skill 時也容易踩坑。自己翻文檔、逐個試裝，成本高且難沉澱經驗。

下面介紹 SkillHub 上架的 WorkBuddySkill使用管理指南（座標 @org-gv4zgi7j/workbuddy-assistant）。它面向「圍繞真實任務」的 Skill 使用與管理，把選擇、安裝、調用、組合和維護放在同一條工作流裏，適合作爲 WorkBuddy 生態裏的 skill-assistant 使用助理來啓用。

這是什麼¶

一句話定位：WorkBuddy Skill 使用管理指南，幫助你在真實任務場景下完成 Skill 的選擇、安裝、調用、組合與維護。

• 維護方：積木Skill（SkillHub 頁面標註爲作者）
• 座標：@org-gv4zgi7j/workbuddy-assistant
• 當前版本：6.8.1（以 SkillHub 頁面爲準）
• 分類：ai-agent
• 來源：enterprise
• 依賴：標籤 requires_api_key=false，無需額外 API Key

SkillHub 統計（抓取資料）：評分 100000，下載 48370 次。頁面與座標以 SkillHub 技能頁 爲準；官方條目地址爲 https://api.skillhub.cn/org-gv4zgi7j/workbuddy-assistant。

核心功能¶

以下能力均來自官方簡介，不展開未在資料中出現的細則：

1. 選擇：按當前任務判斷該用哪些 Skill，減少盲目搜索與試裝。
2. 安裝：配合 SkillHub 安裝流程，把 Skill 裝到當前 Agent 能識別的目錄。
3. 調用：在對話或工作流里正確觸發已安裝的 Skill。
4. 組合：多個 Skill 協同完成複雜任務時的搭配思路。
5. 維護：跟進 Skill 的安裝位置、版本與升級，避免「裝了但 Agent 不加載」。

該 Skill 採用通用 SKILL.md 格式，由 Agent 讀取後按指南執行，而不是單獨跑一個本地服務。

安裝與啓用¶

1、安裝 SkillHub CLI（如尚未安裝）¶

先確認本機是否已有 skillhub：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（CLI + 默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅需要 CLI 時：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

說明：限網環境需使用允許訪問外網的終端執行上述命令。更完整的優先源與首次配置說明見 SkillHub 安裝與優先源配置。

2、安裝本 Skill 到當前 Agent 的 skills 目錄¶

安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄；默認裝到 ./skills/ 時，多數客戶端不會自動加載。

skillhub install @org-gv4zgi7j/workbuddy-assistant --dir <你的 skills 目錄>

常見路徑（來自 SkillHub 安裝文檔，按你當前客戶端選用其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/
• workbuddy：~/.workbuddy/skills/

示例（Cursor 用戶）：

skillhub install @org-gv4zgi7j/workbuddy-assistant --dir ~/.cursor/skills/

3、通過對話讓 AI 代爲安裝（官方頁面方式）¶

SkillHub 技能頁提供的提示詞爲：讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @org-gv4zgi7j/workbuddy-assistant。適合已習慣「把安裝說明交給 Agent 執行」的場景；無論 CLI 還是提示詞安裝，最終仍須保證 Skill 落在上述正確的 skills 目錄。

安裝或更新後，按你所用客戶端的要求重啓或刷新 Agent，使其重新加載 Skill 列表。

典型用法¶

經過上面的步驟啓用本 Skill 後，可以把具體任務交給 Agent，由指南約束其回答範圍。可復現的入口如下。

方式 A：用自然語言描述任務 + 已安裝的助理 Skill

在已加載 @org-gv4zgi7j/workbuddy-assistant 的會話中，直接說明真實任務，例如：

• 「我要在 Cursor 裏做某某開發任務，請根據 WorkBuddy Skill 使用管理指南，推薦應安裝哪些 Skill，並給出 skillhub install 的 --dir 路徑。」
• 「我已在 ~/.cursor/skills/ 安裝了若干 Skill，請幫我梳理調用順序，並說明如何檢查是否被 Agent 識別。」

方式 B：從官方安裝提示詞起步

將 SkillHub 頁面給出的安裝說明發給 AI，完成安裝後再提出與選擇、組合、維護相關的問題。這與頁面「將提示詞發送給你的 AI 安裝該 skills」的流程一致。

上述示例只使用資料中出現的座標、文檔 URL 與目錄約定，不假設額外的配置文件或子命令。

適用場景與注意¶

適合誰

• 使用 WorkBuddy 或 SkillHub，希望在同一套對話裏完成 Skill 選型與維護的開發者。
• 已安裝多個 Skill，需要按任務整理「裝在哪、怎麼調、如何升級」的用戶。
• 分類爲 ai-agent，希望 Agent 側統一管理 Skill 生態的場景。

限制與注意

1. 目錄：未指定正確 --dir 是最常見的「裝了卻無效」原因，安裝前務必對照當前客戶端的 skills 路徑。
2. 版本：文中版本 6.8.1 來自 SkillHub 頁面；升級後以 SkillHub 展示爲準，可用 skillhub 的更新能力（參見安裝文檔第三節）處理。
3. 資料範圍：本介紹未包含 SKILL 正文中的逐步檢查清單或推薦組合表；啓用後行爲以安裝包內 SKILL.md 爲準。
4. 統計數字：下載量、評分會隨 SkillHub 更新變化，引用時以技能頁實時數據爲準。

結尾¶

skill-assistant 使用助理在 SkillHub 上的正式名稱是 WorkBuddySkill使用管理指南：用 @org-gv4zgi7j/workbuddy-assistant 把 Skill 的選擇、安裝、調用、組合和維護串成可執行流程，並依託 SkillHub 的安裝規範減少路徑錯誤。

• SkillHub 技能頁：https://www.skillhub.cn/skills/org-gv4zgi7j/workbuddy-assistant
• 官方條目：https://api.skillhub.cn/org-gv4zgi7j/workbuddy-assistant
• 安裝說明：https://skillhub.cn/install/skillhub.md