SuperAPI AI 工具集

todoist-3

办公与效率

查看项目

更新于 10-16 07:11

技能介绍

用途

Todoist via td CLI 用于在终端中读取和管理 Todoist 的待办事项与任务。当用户询问其待办、任务、日程或清单时,可触发该技能,通过 td(Todoist CLI)完成查询与编辑操作。

安装与验证

仓库地址:https://github.com/Doist/todoist-cli

如果 td 未安装(例如提示 command not found: td),可从仓库安装:

git clone https://github.com/Doist/todoist-cli
cd todoist-cli
npm install
npm run build
npm link

安装后验证:

td --help

主要能力与使用方式

所有 Todoist 操作均通过 td 完成。建议使用可解析输出:

  • 使用 --json(或 --ndjson)列出或读取任务。
  • 使用 td task update ... 进行编辑(内容、到期时间、描述、优先级、标签等)。

快速查看日程:

  • 今日与逾期:td today --json
  • 未来 N 天:td upcoming 7 --json
  • 收件箱:td inbox --json

向用户汇总日程时,应区分“逾期”和“今日到期”(可选包含“即将到来”),并在存在时包含优先级(p1–p4)与标签。

查找要编辑的任务

优先方式:

  • 若已知任务 id,直接使用,引用格式为 id:<taskId>(例如 id:6WcqCcR4wF7XW5m6)。
  • 若只有标题或片段,先搜索/列出再匹配:td task list --json(可结合 today、upcoming、inbox 等列表命令过滤),然后根据内容、到期时间与项目选择正确条目。

查看单个任务:

td task view <ref> --json

常见编辑操作

  • 更新描述(备注):td task update <ref> --description "..."
  • 更新标题/内容:td task update <ref> --content "New task title"
  • 修改到期日期/时间(自然语言通常可用):td task update <ref> --due "tomorrow 3pm"
  • 优先级:td task update <ref> --priority p1(或 p2/p3/p4)
  • 标签(会替换现有标签):td task update <ref> --labels "Chores,Calls"
  • 完成/重新打开:td task complete <ref>、td task uncomplete id:<taskId>
  • 删除:td task delete <ref> --yes(仅在用户明确要求删除时使用)

添加任务

快速自然语言添加:

td add "Call dentist tomorrow 10am p2 #Personal"

或使用结构化字段显式添加:

td task add --content "..." --due "..." --priority p2 --labels "..."

安全与体验

  • 破坏性操作(如删除)前需确认。
  • 若多个任务与用户描述匹配,应先提问澄清(或展示候选项)再更新。
  • 当用户要求添加信息(如电话号码)时,除非明确要求写入标题,否则应放入描述。

适用场景

适用于需要以命令行方式查询日程、管理 Todoist 任务、批量或结构化编辑任务字段的场景。

限制

关于该技能是否收费、价格、支持平台、效果等,资料暂未提供。