Agent Skills
返回列表
WorkBuddy故障修复

WorkBuddy故障修复

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,将 @user_5fb4ec10/workbuddy-fault-repair 安装到你的 AI 助手中。

技能介绍

要解决的具体问题

WorkBuddy 长期运行后容易积累三类故障:

  • 状态类故障:路径迁移导致 MEMORY.md 不在当前工作区、历史对话被清空、记忆断联;或记忆失效,表现为每次对话从零开始、不读 MEMORY.md、反复遗忘用户偏好。
  • 资源访问类故障:FileNotFoundError、路径不存在、相对路径失效;Skill 文件乱码、中文显示异常、UTF-8 报错;沙箱拦截导致命令被拒、权限不足。
  • 行为控制类故障:触发词不生效、SKILL.md 未读取;AI 只输出文字不行动、工具不被调用;定时任务不触发;/folder 切换后工作区仍绑旧路径,产出物存错位置。

这些故障会直接中断自动化流程,且症状分散,靠临时提示词很难定位根因。

核心能力与工作流程

技能采用「诊断 → 修复 → 验证」三段式流程:

  1. 故障诊断:收集用户描述的症状,与 10 种常见故障表逐一匹配。表中按优先级分为 P0(路径迁移、路径报错、记忆失效)、P1(编码问题、Skill 加载不上、沙箱拦截、指令无响应)和 P2(格式出错、定时任务不执行、工作区绑定失效)。匹配成功即执行对应修复步骤;未匹配则退化为基础排查,检查路径、编码、权限三项。
  2. 修复执行:每种故障都有独立的三步修复方案,覆盖路径迁移、路径报错、记忆失效、编码问题、Skill 加载不上、沙箱拦截、指令无响应、格式出错、定时任务不执行、工作区绑定失效。
  3. 验证修复:修复后重新执行故障的触发操作,确认是否仍报错。成功则输出修复报告;失败则升级处理,提示用户手动操作。

适用边界与注意点

  • 诊断依赖用户对症状的描述,描述与 10 种故障表完全无关时只能走基础排查,不保证一次命中。
  • P1/P2 中的部分故障(如定时任务不执行)涉及 rrule 格式错误、CWD 配置错误,自动修复后仍可能残留问题,需按升级流程手动介入。
  • 验证标准仅为重新执行触发操作,不做额外回归测试。

使用场景

  • WorkBuddy 工作区路径变更后,MEMORY.md 丢失、历史对话清空,需要定位路径迁移并恢复记忆文件
  • 自定义 Skill 触发词失效、SKILL.md 未被读取,需诊断 skill 目录异常并修复加载流程
  • 配置的定时任务到期后未执行,需排查 rrule 格式与 CWD 配置错误并恢复 automation 触发
  • 沙箱环境拒绝文件写入或命令执行,需定位权限不足原因并解除拦截

适合人员

  • 依赖 WorkBuddy 管理项目文件、频繁切换工作区遇到路径报错的全栈开发
  • 配置了定时自动化任务、需要排查任务不触发问题的流程编排工程师
  • 使用 MEMORY.md 做长期记忆、遇到记忆断联需要恢复的 AI 辅助办公人员
  • 维护自定义 Skill 目录、遇到触发词失效或文件乱码的 Agent 集成开发者