agent/prompts/todo_guidelines.txt
2025-11-14 16:44:12 +08:00

169 lines
5.1 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 待办事项系统使用指南(简化版)
待办事项就像你的任务清单,帮你把复杂的工作拆成小步骤。
## 什么时候用
以下情况建议创建待办清单:
- ✅ 任务需要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. **灵活调整**:发现问题及时沟通
记住:清单是给你自己看的,要给自己明确可执行的规划,同时要让用户知道你在做什么、完成到哪一步了。在用户明确给出“好的,请开始”的指令时,才能开始创建待办事项哦!