前言¶
家裏空調不製冷、洗衣機不排水、馬桶一直流水時，多數人會在搜索引擎裏零散地看幾篇帖子，很難判斷該先查哪一項、能不能自己動手。請師傅上門又擔心小題大做。若希望對話式 Agent 能按固定流程問清現象、從簡單到複雜給出排查步驟，並明確安全邊界，可以把 SkillHub 上的社區 Skill「維修指南」裝進當前 Agent 的 skills 目錄，由 SKILL.md 約束觸發條件與輸出結構。
這是什麼¶
「維修指南」（座標 @user_70c2f807/repair-guide，當前版本 1.0.1）由社區發佈者 user_70c2f807 維護，來源爲 community，在 SkillHub 分類爲 it-ops-security。Skill 標籤 requires_api_key=false，不依賴外部 API Key。
定位是：針對常見家電和家居設施的小故障，提供系統化排查步驟與簡單維修指導，幫助用戶定位問題、評估自修可行性。官方頁面與元數據入口：
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_70c2f807/repair-guide
- API 座標頁：https://api.skillhub.cn/user_70c2f807/repair-guide
截至資料抓取時，SkillHub 側評分爲 100000，下載 873 次（安裝計數爲 0，以頁面統計爲準）。
不適用（Skill 內明確排除）：專業維修服務代辦、電器購買選型、安全檢測類需求。涉及電路板、壓縮機、強電接線、燃氣、製冷劑加註、高處作業等，應轉專業人員。
核心功能¶
以下能力均來自 Skill 自帶的 SKILL.md 說明：
- 觸發識別：用戶提到維修、家電故障、怎麼修，或英文 repair guide / fix appliance / troubleshoot 等時啓用。
- 故障信息採集：確認設備與型號、現象、是否曾有異響/漏水/燒焦味、是否在保修期。
- 原因分析與排查：按可能性排序列出原因，給出從簡到難的檢查步驟，並標註自修難度與安全注意。
- 維修指導：說明操作步驟、所需工具與預期效果。
- 決策與後續：判斷是否需要專業維修、維修費用參考區間、預防性維護建議。
- 結構化輸出：按模板輸出「故障現象、自修難度、安全風險、原因表、分步排查、安全提醒、是否找師傅、預防建議」等區塊。
- 異常話術：描述模糊、安全風險、保修期內、缺工具等場景有固定提示語。
輸出原則強調：安全置頂、從簡到難、步驟可執行、知進退、故障解決後給預防建議。
安裝與啓用¶
SkillHub 推薦兩種方式，任選其一即可。
方式一：讓 Agent 按官方安裝文檔執行¶
把下面提示發給已支持 Skills 的 AI 客戶端（如 Cursor、Claude Code 等），由 Agent 讀取安裝說明並落到本機 skills 目錄：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_70c2f807/repair-guide`。
安裝文檔要求：使用 skillhub install 時必須加 --dir，指向當前 Agent 實際讀取的 skills 目錄；裝到默認 ./skills/ 而 Agent 不讀該路徑時，Skill 不會被加載。
常用目錄（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
方式二：本機用 skillhub CLI 安裝¶
先確認 CLI 是否可用：
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 文檔執行完整安裝或僅 CLI（文檔地址：https://skillhub.cn/install/skillhub.md）。
安裝本 Skill 時，索引中的命令爲帶命名空間的形式：
skillhub install repair-guide --namespace user_70c2f807 --dir <你的 Agent skills 目錄>
例如 Cursor 用戶可將 <你的 Agent skills 目錄> 替換爲 ~/.cursor/skills/。安裝成功後，包路徑一般爲該目錄下的 @user_70c2f807/repair-guide，內含 SKILL.md。
經上述步驟安裝後，重啓或重新加載 Agent（若你的客戶端需要），再在對話中描述家電故障即可觸發。
典型用法¶
Skill 文檔中的快速開始示例可直接復現（Agent 會按 SKILL.md 展開爲完整排查輸出）：
| 用戶說法 | Skill 側預期行爲 |
|---|---|
| 空調不製冷怎麼辦？ | 按濾網 → 製冷模式 → 遙控器 → 室外機 → 製冷劑等順序排查 |
| 洗衣機不排水 | 分析排水管堵塞、排水泵、程序設置等，給出逐步方案 |
| 馬桶一直流水 | 區分浮球與密封墊等問題，給出簡單修理步驟 |
| 這個問題我能自己修嗎？ | 評估難度與安全性，建議是否找專業維修 |
| 燈泡怎麼換？ | 說明斷電等安全前提下的更換步驟 |
執行流程在 Skill 中固定爲四步：瞭解故障 → 故障分析 → 維修指導 → 後續建議（含預防與何時找師傅）。
適用場景與注意¶
適合誰
- 希望在家電、衛浴、燈具等小故障上先自助排查的終端用戶或家庭場景。
- 需要在對話裏統一輸出格式、減少 Agent「泛泛建議」的 Skill 使用者。
限制與坑
- 僅限簡單故障：複雜部件與高危操作必須找持證人員；Skill 明確不承擔自行維修風險。
- 無法遠程確診：只能根據文字描述推測，現場情況可能不同。
- 保修期：文檔建議保修期內優先聯繫售後，自行拆機可能影響保修。
- 安裝路徑：務必
--dir指向 Agent 識別的目錄；本 Skill 在社區索引中需--namespace user_70c2f807，否則可能下載失敗。 - 分類標籤：SkillHub 歸類爲 it-ops-security，與「家居維修方法論」的 Skill 內容並不矛盾，檢索時以名稱與座標爲準。
結尾¶
「維修指南」把家電與家居小故障的問診、排序排查、安全邊界和是否找師傅，收斂成可複用的 Agent 指令與輸出模板，且無需 API Key。若你要在 Cursor 等環境中落地，可從 SkillHub 頁面查看版本信息，並按上文命令安裝到對應 skills 目錄：
https://www.skillhub.cn/skills/user_70c2f807/repair-guide
