Files
add-todo-all/TUTORIAL.md
2026-09-09 10:29:02 +08:00

67 lines
2.6 KiB
Markdown
Raw Permalink 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.
# 待办事项管理 使用教程
用最短路径带你完成一次从「新建待办」到「标记完成」的完整使用。
---
## 开始前
确认:
1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能(或更新到最新版)
3. 本技能使用本地数据库存储待办,首次使用会自动初始化,无需手动准备
4. 如需设置截止时间,请提前想好具体日期时间;优先级可选「高 / 中 / 低」,不写默认「中」
---
## 第一步:打开技能并说清目标
在匠厂里新建任务或打开对话,用自然语言说明要做什么,例如:
> “帮我加一条待办:周五前提交项目周报,优先级高。”
>
> “帮我看看现在有哪些待办。”
>
> “把第 3 条待办标记为完成。”
建议一次只交代一件事;范围说清楚,减少来回确认。
---
## 第二步:按提示补充信息
如果 Agent 问你缺什么,按提示补充即可。
- **新增待办时**:标题是必填的;优先级和截止时间可选,不写会用默认值(优先级「中」,无截止时间)
- **标记完成 / 删除时**:需要提供待办编号(可一次给多个,用逗号隔开)
- **查看列表时**:可指定只看「待办中」或「已完成」,不指定则全部列出
---
## 第三步:等待结果并核对
任务结束后,请核对:
- **新增成功**:会返回这条待办的编号、标题、状态、优先级等信息,请记下编号以便后续操作
- **列表查询**:会返回待办清单,默认按创建时间倒序,最多 100 条
- **标记完成 / 删除**:会逐条返回成功或失败,注意看是否有编号不存在、或已完成状态无法重复标记的情况
- **统计**:会显示总数、待办数、完成数
若失败,先看失败原因说明,再按下一节排查。
---
## 常见卡住怎么办
| 现象 | 你可以先试 |
|------|------------|
| 提示标题不能为空 | 重新发起,把待办内容说清楚(标题不能留空) |
| 提示待办编号不存在 | 先用「查看待办列表」确认正确编号,再操作 |
| 提示该待办已是完成状态 | 已完成的待办不能重复标记完成,无需再操作 |
| 优先级不生效 | 优先级只能是「高 / 中 / 低」,请用这三个词之一 |
| 截止时间不对 | 截止时间请用明确的日期时间表述(如「明天下午 6 点」「9 月 10 日 18:00」),避免模糊说法 |
| 列表数据为空 | 确认是否还没有新增过待办;或是否筛选了「已完成」但没有已完成项 |
仍无法解决时,把「你说了什么 + 界面提示原文」发给支持人员,便于排查。