前言¶
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 。
