前言¶
WorkBuddy 一旦報錯、卡住、連不上或任務不執行，常見做法是翻日誌、猜代理或連接器狀態，再對照文檔試錯。workbuddy-guide 類使用指南能講清功能，但不會替你掃環境、對症狀做模式匹配。下面介紹社區 Skill WorkBuddy 智能診斷助手（座標 @user_73de2035/workbuddy-diagnobuddy）：在 Agent 裏觸發後，由技能驅動「跑診斷腳本 → 識別錯誤 → 輸出結論與修復步驟」，必要時生成可直接提交的官方反饋文案。
這是什麼¶
WorkBuddy 智能診斷助手是發佈在 SkillHub 上的 Agent Skill，當前版本 1.0.12，分類爲 it-ops-security，來源爲 community，發佈者爲 user_73de2035。標籤標明 requires_api_key=false，安裝與使用不依賴額外 API Key。
定位是 WorkBuddy 的主動診斷引擎：與使用指南類 Skill 不同，它強調一鍵執行診斷腳本，自動掃描代理、連接器、日誌、網絡與客戶端檢測結果，再匹配常見錯誤模式並給出結構化研判與驗證提示。
核心功能¶
依據官方簡介，已覈實的能力包括：
- 環境掃描：診斷腳本覆蓋代理、連接器、日誌、網絡及客戶端檢測結果。
- 錯誤匹配：支持中文日誌自動命中，也支持用口語化症狀描述直達匹配（與
--symptom參數對應）。 - 可執行輸出：說明問題在哪、怎麼修，並附結構化研判與驗證提示。
- 複雜問題兜底：可自動生成官方反饋文案，複製即可提交。
- 腳本參數（診斷腳本側）：
---symptom：描述症狀；
---json：輸出機器可讀結果；
---version：查看版本。
在對話中的典型觸發包括用戶說「診斷一下」「檢查環境」「出問題了」「幫我排查」，或出現連接器斷開、調用失敗、自動化不執行等故障場景。
安裝與啓用¶
Skill 遵循通用 SKILL.md 格式。SkillHub 頁面給出的安裝方式爲：按 SkillHub 安裝說明 操作，並安裝下列座標：
@user_73de2035/workbuddy-diagnobuddy
頁面亦提供可發給 AI 的提示詞：「請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_73de2035/workbuddy-diagnobuddy。」具體命令行或各客戶端（Cursor、Codex CLI、Claude Code）的差異以該安裝文檔爲準；本文未單獨覈實到的客戶端差異不展開。
官方資源地址：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_73de2035/workbuddy-diagnobuddy
- API 入口：https://api.skillhub.cn/user_73de2035/workbuddy-diagnobuddy
典型用法¶
安裝並啓用 Skill 後，在 Agent 對話裏用自然語言發起排查即可，例如說明 WorkBuddy 連不上、任務不跑或連接器斷開。技能會按「跑腳本 → 識別錯誤 → 輸出結論 + 修復動作」的流程工作。
若需把症狀直接交給診斷腳本，可使用簡介中提到的 --symptom；需要接入自動化流水線或二次處理時，使用 --json 獲取結構化結果；覈對診斷腳本版本時使用 --version。具體腳本路徑與完整命令行以 Skill 包內 SKILL.md 及附帶腳本爲準（安裝完成後由 Agent 按技能說明調用）。
適用場景與注意¶
適合誰：日常使用 WorkBuddy、需要在故障時快速收斂到「原因 + 修復步驟」的開發者或運維；希望少翻文檔、少手工拼環境信息的人。
與指南類 Skill 的分工：需要系統學習 WorkBuddy 功能時仍可用 workbuddy-guide；本 Skill 側重故障時的主動診斷，二者互補而非替代。
注意：
- 結論依賴診斷腳本掃描到的環境與日誌；若本機權限或網絡導致掃描不完整，輸出可能仍需人工補充。
- 社區來源（community），行爲與規則以 Skill 包內文檔及 SkillHub 上架版本爲準；升級時關注座標版本（當前頁面展示 v1.0.12）。
結尾¶
WorkBuddy 智能診斷助手把「猜問題」收成可復現的診斷腳本與模式匹配，並在複雜場景下生成可提交的反饋文案。需要安裝或查看說明時，請訪問 SkillHub 官方頁面：https://www.skillhub.cn/skills/user_73de2035/workbuddy-diagnobuddy 。
