WorkBuddy故障修复
将以下提示词粘贴到你的 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切换后工作区仍绑旧路径,产出物存错位置。
这些故障会直接中断自动化流程,且症状分散,靠临时提示词很难定位根因。
核心能力与工作流程
技能采用「诊断 → 修复 → 验证」三段式流程:
- 故障诊断:收集用户描述的症状,与 10 种常见故障表逐一匹配。表中按优先级分为 P0(路径迁移、路径报错、记忆失效)、P1(编码问题、Skill 加载不上、沙箱拦截、指令无响应)和 P2(格式出错、定时任务不执行、工作区绑定失效)。匹配成功即执行对应修复步骤;未匹配则退化为基础排查,检查路径、编码、权限三项。
- 修复执行:每种故障都有独立的三步修复方案,覆盖路径迁移、路径报错、记忆失效、编码问题、Skill 加载不上、沙箱拦截、指令无响应、格式出错、定时任务不执行、工作区绑定失效。
- 验证修复:修复后重新执行故障的触发操作,确认是否仍报错。成功则输出修复报告;失败则升级处理,提示用户手动操作。
适用边界与注意点
- 诊断依赖用户对症状的描述,描述与 10 种故障表完全无关时只能走基础排查,不保证一次命中。
- P1/P2 中的部分故障(如定时任务不执行)涉及
rrule格式错误、CWD配置错误,自动修复后仍可能残留问题,需按升级流程手动介入。 - 验证标准仅为重新执行触发操作,不做额外回归测试。
使用场景
- WorkBuddy 工作区路径变更后,MEMORY.md 丢失、历史对话清空,需要定位路径迁移并恢复记忆文件
- 自定义 Skill 触发词失效、SKILL.md 未被读取,需诊断 skill 目录异常并修复加载流程
- 配置的定时任务到期后未执行,需排查 rrule 格式与 CWD 配置错误并恢复 automation 触发
- 沙箱环境拒绝文件写入或命令执行,需定位权限不足原因并解除拦截
适合人员
- 依赖 WorkBuddy 管理项目文件、频繁切换工作区遇到路径报错的全栈开发
- 配置了定时自动化任务、需要排查任务不触发问题的流程编排工程师
- 使用 MEMORY.md 做长期记忆、遇到记忆断联需要恢复的 AI 辅助办公人员
- 维护自定义 Skill 目录、遇到触发词失效或文件乱码的 Agent 集成开发者