# ERRORS.md - 错误记录

## 2026-03-10: kb-workflow 流程执行不完整

### 发生了什么
用户请求"添加到知识库 + 链接"，我启动了 kb-workflow 技能，但两次漏掉步骤：
1. 第一次：只做了链接解析、元数据提取、内容提取，漏掉了深度分析
2. 第二次：深度分析完成后，漏掉了归档步骤

### 根本原因
1. **没有建立步骤检查清单** - SKILL.md 明确列出了8个步骤，但我没有逐项核对
2. **并行子代理导致认知偏差** - 启动3个子代理处理后以为工作结束了
3. **过早汇报完成** - 在步骤4完成后就向用户汇报，没有继续后续步骤
4. **忘记归档是必须步骤** - 即使分析完成了，归档才是最终目标

### 正确做法
```
1. 执行技能前，先列出完整步骤清单
2. 每完成一步，标记状态 [x]
3. 全部完成后，再次核对清单
4. 全部 ✅ 才能向用户汇报完成
```

### kb-workflow 完整步骤清单（必须全部执行）
| 步骤 | 内容 | 状态 |
|------|------|------|
| 1 | 环境变量检查 | [ ] |
| 2 | 链接解析 (kb-link-parser) | [ ] |
| 3 | 元数据提取 (kb-xxx-metadata) | [ ] |
| 4 | 内容下载/提取 (kb-xxx-content) | [ ] |
| 5 | 语音识别（视频才需要）| [ ] 或 [跳过] |
| 6 | 深度分析 (kb-deep-analyzer) | [ ] |
| 7 | 归档 (kb_workflow.py --archive-file) | [ ] |
| 8 | NAS 同步 + 汇报完成 | [ ] |

### 如何避免再犯
- 每次执行 kb-workflow，必须使用上面的清单逐项核对
- 最后一步"归档"没完成，不算完成
- 用户问"为什么没XX"时，立即检查是否漏步骤