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

2.6 KiB
Raw Permalink Blame History

待办事项管理 使用教程

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


开始前

确认:

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

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

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

“帮我加一条待办:周五前提交项目周报,优先级高。”

“帮我看看现在有哪些待办。”

“把第 3 条待办标记为完成。”

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


第二步:按提示补充信息

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

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

第三步:等待结果并核对

任务结束后,请核对:

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

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


常见卡住怎么办

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

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