# 待办事项管理 使用教程

用最短路径带你完成一次从「新建待办」到「标记完成」的完整使用。

---

## 开始前

确认：

1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能（或更新到最新版）
3. 本技能使用本地数据库存储待办，首次使用会自动初始化，无需手动准备
4. 如需设置截止时间，请提前想好具体日期时间；优先级可选「高 / 中 / 低」，不写默认「中」

---

## 第一步：打开技能并说清目标

在匠厂里新建任务或打开对话，用自然语言说明要做什么，例如：

> “帮我加一条待办：周五前提交项目周报，优先级高。”
>
> “帮我看看现在有哪些待办。”
>
> “把第 3 条待办标记为完成。”

建议一次只交代一件事；范围说清楚，减少来回确认。

---

## 第二步：按提示补充信息

如果 Agent 问你缺什么，按提示补充即可。

- **新增待办时**：标题是必填的；优先级和截止时间可选，不写会用默认值（优先级「中」，无截止时间）
- **标记完成 / 删除时**：需要提供待办编号（可一次给多个，用逗号隔开）
- **查看列表时**：可指定只看「待办中」或「已完成」，不指定则全部列出

---

## 第三步：等待结果并核对

任务结束后，请核对：

- **新增成功**：会返回这条待办的编号、标题、状态、优先级等信息，请记下编号以便后续操作
- **列表查询**：会返回待办清单，默认按创建时间倒序，最多 100 条
- **标记完成 / 删除**：会逐条返回成功或失败，注意看是否有编号不存在、或已完成状态无法重复标记的情况
- **统计**：会显示总数、待办数、完成数

若失败，先看失败原因说明，再按下一节排查。

---

## 常见卡住怎么办

| 现象 | 你可以先试 |
|------|------------|
| 提示标题不能为空 | 重新发起，把待办内容说清楚（标题不能留空） |
| 提示待办编号不存在 | 先用「查看待办列表」确认正确编号，再操作 |
| 提示该待办已是完成状态 | 已完成的待办不能重复标记完成，无需再操作 |
| 优先级不生效 | 优先级只能是「高 / 中 / 低」，请用这三个词之一 |
| 截止时间不对 | 截止时间请用明确的日期时间表述（如「明天下午 6 点」「9 月 10 日 18:00」），避免模糊说法 |
| 列表数据为空 | 确认是否还没有新增过待办；或是否筛选了「已完成」但没有已完成项 |

仍无法解决时，把「你说了什么 + 界面提示原文」发给支持人员，便于排查。