前言¶
家里空调不制冷、洗衣机不排水、马桶一直流水时，多数人会在搜索引擎里零散地看几篇帖子，很难判断该先查哪一项、能不能自己动手。请师傅上门又担心小题大做。若希望对话式 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
