WorkBuddy故障修复
当你遇到以下任何情况时，立即启动此技能执行故障诊断与修复流程：
- 用户提到"WorkBuddy报错"/ "路径报错"/ "记忆失效"
- 用户提到"Skill加载不上"/ "沙箱拦截"/ "指令无响应"
- 用户提到"格式出错"/ "定时任务不执行"/ "WorkBuddy故障"
- 任何WorkBuddy操作异常的表现
第1步：故障诊断
扫描以下10种常见故障，匹配症状：
| # | 故障 | 典型症状 | 优先级 |
|---|---|---|---|
| 1 | 路径迁移 | MEMORY.md不在当前工作区、历史对话清空、记忆断联 | P0 |
| 2 | 路径报错 | FileNotFoundError、路径不存在、相对路径失效 | P0 |
| 3 | 记忆失效 | AI每次从零开始、不读MEMORY.md、反复遗忘偏好 | P0 |
| 4 | 编码问题 | Skill文件乱码、中文显示异常、UTF-8报错 | P1 |
| 5 | Skill加载不上 | 触发词不生效、SKILL.md未读取、skill目录异常 | P1 |
| 6 | 沙箱拦截 | 命令被拒、权限不足、操作被block | P1 |
| 7 | 指令无响应 | AI不执行操作、只输出文字不行动、工具不调用 | P1 |
| 8 | 格式出错 | HTML输出异常、编码混乱、字符显示错误 | P2 |
| 9 | 定时任务不执行 | automation不触发、rrule格式错、CWD配置错 | P2 |
| 10 | 工作区绑定失效 | /folder切换后仍绑旧路径、产出物存错位置 | P2 |
诊断方法：
1. 收集用户描述的症状
2. 匹配10种故障表中的典型症状
3. 如果匹配到→执行对应修复步骤
4. 如果未匹配→尝试基础排查（路径+编码+权限）
第2步：修复执行
每种故障的3步修复方案：
故障1：路径迁移
1. 确认正确路径 → ls验证目录存在
2. 切换工作区 → /folder切换到正确路径
3. 重新绑定 → 重新勾选授权+验证MEMORY.md加载
故障2：路径报错
1. 替换所有相对路径为绝对路径
2. 检查路径中是否有特殊字符/中文/空格
3. 用短路径替代长路径（Windows路径有时超限）
故障3：记忆失效
1. 触发"会话记忆自检与修复"skill → 5步自检
2. 如果自检发现断联 → 执行对应修复
3. 如果自检正常但AI仍不读 → 重启WorkBuddy
故障4：编码问题
1. 检查文件编码 → 确认UTF-8（无BOM）
2. 转换编码 → 重新保存为UTF-8
3. 用VS Code编辑（不是记事本/不是Word）
故障5：Skill加载不上
1. 检查SKILL.md格式 → frontmatter完整+triggers正确
2. 检查skill路径 → .workbuddy/skills/或~/.workbuddy/skills/
3. 检查编码 → UTF-8+无BOM+无乱码
故障6：沙箱拦截
1. 确认是否需要沙箱外操作 → 是否有更安全的替代
2. 如果必须 → 使用dangerouslyDisableSandbox（需用户确认）
3. 检查是否是路径权限问题 → 修正CWD
故障7：指令无响应
1. 检查指令是否明确 → 触发"指令意图校准"skill
2. 检查AI是否在Ask模式 → 切换到Craft模式
3. 检查是否有权限限制 → 沙箱/文件权限
故障8：格式出错
1. 检查输出格式指定 → 是否在MEMORY.md写明格式偏好
2. 检查编码环境 → 终端编码+文件编码是否一致
3. 用标准工具（Write/Edit）替代shell命令输出
故障9：定时任务不执行
1. 检查automation配置 → rrule格式+CWD路径
2. 检查validFrom/validUntil → 是否在有效期内
3. 检查automation status → 是否ACTIVE而非PAUSED
故障10：工作区绑定失效
1. 确认当前工作区路径 → pwd/ls验证
2. /folder切换到正确路径
3. 检查产出物是否存入唯一主路径下的产出物目录
第3步：验证修复
修复后必须验证：
1. 重新执行故障的触发操作 → 看是否仍然报错
2. 如果修复成功 → 输出修复报告
3. 如果修复失败 → 自动重试一次（换一种修复方式）
4. 如果重试仍失败 → 升级处理（提示用户手动操作+给出具体的手动步骤）
复杂问题的重试策略
| 首次尝试失败 | 重试方案 | 仍失败则 |
|---|---|---|
| 路径问题→/folder切换失败 | 尝试用绝对路径直接操作 | 提供完整手动操作命令 |
| 记忆修复→日志恢复不完整 | 用conversation_search补充搜索 | 生成临时骨架请用户确认 |
| Skill加载→格式检查通过仍报错 | 尝试重新安装该Skill | 提供手动安装步骤 |
| 权限问题→sandbox放行失败 | 检查是否有替代的非危险操作 | 建议用户在客户端手动授权 |
输出格式
## WorkBuddy故障修复报告
**故障类型**：[1-10号·具体故障名]
**症状描述**：[用户描述]
**诊断结果**：[匹配的故障类型]
### 修复步骤
| 步骤 | 执行内容 | 结果 |
|------|---------|------|
| 1 | [具体操作] | ✅/❌ |
| 2 | [具体操作] | ✅/❌ |
| 3 | [具体操作] | ✅/❌ |
### 验证结果
- [重新执行后是否正常]
### 如果再次遇到
- [预防措施]
版本记录
- v1.1 (2026-07-07)：基于SkillHub评测反馈——新增复杂问题重试策略(自动重试1次+4类升级处理方案)
- v1.0 (2026-07-03)：初始版本——10种故障诊断+3步修复方案+验证流程+输出模板
