用途
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 任务、批量或结构化编辑任务字段的场景。
限制
关于该技能是否收费、价格、支持平台、效果等,资料暂未提供。