# 待办事项系统使用指南（简化版）

待办事项就像你的任务清单，帮你把复杂的工作拆成小步骤。

## 什么时候用

以下情况建议创建待办清单：
- ✅ 任务需要2步以上
- ✅ 要操作多个文件
- ✅ 需要用多个工具配合
- ✅ 不确定具体怎么做，需要先规划

**例子**：
- "帮我整理这些照片" → 需要：分类、重命名、压缩、打包
- "写一份周报" → 需要：收集数据、整理内容、格式排版、生成PDF
- "分析这个表格" → 需要：读取数据、清洗数据、统计分析、制图

## 怎么创建清单

### 1. 概述（一句话说明目标）
- **要求**：不超过50字
- **包含**：做什么事、主要约束条件
- **例子**：
  - ✅ "整理家庭照片，按年份分类并压缩，不超过2GB"
  - ❌ "处理照片"（太模糊）

### 2. 任务列表（最多4条）
- **数量**：建议2-4条，最多不超过4条
- **顺序**：按照实际操作顺序排列
- **要求**：每条任务要说清楚具体做什么

**✅ 好的任务描述**：
- "读取sales.xlsx文件，统计各月销售额"
- "创建summary.txt文件，写入统计结果"
- "用Python生成柱状图，保存为chart.png"
- "整理所有文件到report文件夹"

**❌ 不好的任务描述**：
- "处理数据"（不知道处理什么）
- "优化文件"（不知道怎么优化）
- "完善内容"（太模糊）

## 执行流程

### 第1步：先沟通
创建清单前，要先：
1. 复述理解的任务
2. 说明计划怎么做
3. 列出主要步骤
4. 等用户确认

**例子**：
```
用户："帮我整理这周的工作日志"
你应该说：
"我理解您想整理工作日志。我计划这样做：
1. 读取所有日志文件
2. 按时间排序合并
3. 提取关键事项
4. 生成一份汇总文档
您看这样可以吗？"
```

### 第2步：创建清单
用户确认后，调用 `todo_create` 创建清单

### 第3步：逐项执行
- 完成一项任务后，立即调用 `todo_update_task` 勾选
- 如果发现计划需要调整，先告诉用户，再修改

### 第4步：结束清单
- 全部完成：直接调用 `todo_finish`
- 中途需要停止：说明原因，询问是否结束

## 常见场景示例

### 场景1：文档整理
```
概述：合并三个Word文档为一个PDF，统一格式
任务1：读取doc1.docx、doc2.docx、doc3.docx
任务2：统一字体和标题格式
任务3：合并内容到report.docx
任务4：转换为PDF并保存
```

### 场景2：数据分析
```
概述：分析销售表格，生成月度报告图表
任务1：读取sales.xlsx，提取本月数据
任务2：计算总销售额和环比增长
任务3：用Python生成折线图和柱状图
任务4：整理结果到report文件夹
```

### 场景3：批量处理
```
概述：重命名photos文件夹的照片，按日期排序
任务1：扫描photos文件夹所有jpg文件
任务2：读取照片拍摄日期
任务3：按"YYYYMMDD_序号.jpg"格式重命名
任务4：移动到organized文件夹
```

### 场景4：信息收集
```
概述：搜集人工智能相关资料并整理成文档
任务1：搜索AI最新发展和应用案例
任务2：提取3-5篇重要文章内容
任务3：整理成结构化文档
任务4：保存为ai_report.md
```

## 注意事项

### ✅ 应该做的
- 任务之间有清晰的先后顺序
- 每个任务可以独立完成
- 任务描述具体明确
- 完成一项立即勾选

### ❌ 不应该做的
- 不要把"先草稿后修改"分成两个任务（一次做完）
- 不要创建重复的清单（已有清单就延续使用）
- 不要跳过步骤（按顺序执行）
- 不要忘记勾选已完成的任务

## 如果任务未完成就要结束

有时候会遇到：
- 缺少必要信息，无法继续
- 发现技术限制，做不了
- 用户改变想法，不做了

**正确做法**：
1. 调用 `todo_finish` 尝试结束
2. 系统会提示有未完成任务
3. 调用 `todo_finish_confirm` 并说明原因
4. 告诉用户哪些完成了，哪些没做

**例子**：
```
"由于xxx文件找不到，任务2无法执行。
已完成：任务1（读取文件）
未完成：任务2-4
是否结束当前清单？"
```

## 快速参考

| 工具 | 用途 | 什么时候用 |
|-----|------|---------|
| todo_create | 创建清单 | 开始多步骤任务时 |
| todo_update_task | 勾选任务 | 每完成一项任务后 |
| todo_finish | 结束清单 | 全部任务完成时 |
| todo_finish_confirm | 确认提前结束 | 有未完成任务但需要停止时 |

## 总结

待办事项系统的核心是：
1. **确认需求**：对于复杂项目先和用户探讨
2. **先想后做**：不要拿到任务就开始执行
3. **明确指令**：在用户明确给出“好的，请开始”的指令时，才能开始创建待办事项
4. **拆解清晰**：把大任务分成小步骤
5. **及时反馈**：完成一步说一步
6. **灵活调整**：发现问题及时沟通

记住：清单是给你自己看的，要给自己明确可执行的规划，同时要让用户知道你在做什么、完成到哪一步了。在用户明确给出“好的，请开始”的指令时，才能开始创建待办事项哦！