1.6 KiB
1.6 KiB
ERRORS.md - 错误记录
2026-03-10: kb-workflow 流程执行不完整
发生了什么
用户请求"添加到知识库 + 链接"，我启动了 kb-workflow 技能，但两次漏掉步骤：
- 第一次：只做了链接解析、元数据提取、内容提取，漏掉了深度分析
- 第二次：深度分析完成后，漏掉了归档步骤
根本原因
- 没有建立步骤检查清单 - SKILL.md 明确列出了8个步骤，但我没有逐项核对
- 并行子代理导致认知偏差 - 启动3个子代理处理后以为工作结束了
- 过早汇报完成 - 在步骤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"时，立即检查是否漏步骤