Todoist 自然语言任务解析器

解决的具体问题

在团队协作中，任务常常以自然语言的形式出现，比如「明天下午 3 点前把需求文档发给设计组，优先级高」。而 Todoist API v2 要求提交的是结构化的任务对象，必须包含 due_date、priority、project_id 等字段。手动把自然语言拆成这些字段不仅耗时，还容易出错——比如忘记给重复任务写 RRULE 规则，或者漏掉地点提醒所需的 resource_types 参数，结果任务创建失败或提醒不生效。

核心能力与工作步骤

这个技能负责把自然语言任务描述解析成符合 Todoist Sync API 规范的任务对象，关键步骤如下：

• 任务内容提取：从文本中识别核心动作（如「发需求文档」），映射到 API 的 content 字段
• 时间解析：把「明天下午 3 点前」转换为 due_datetime，支持绝对时间（如「3 月 15 日」）和相对时间（如「下周一」）
• 优先级映射：将「优先级高」转换为 1–4 的整数（1 为最高），符合 priority 字段的取值约定
• 项目分配：通过关键词匹配（如「设计组」）关联到对应的 project_id
• 重复规则支持：将「每周五提交」解析为 RRULE:FREQ=WEEKLY;BYDAY=FR，支持常见的重复模式

适用边界与注意点

• 依赖 Todoist API v2 的字段规范，目标项目必须已存在且 project_id 有效
• 要获取两种提醒（时间提醒和地点提醒），请求中必须同时包含 resource_types=["reminders", "reminders_location"]
• 临时任务 ID 需要使用 tmp- 前缀（如 tmp-task-001），避免和正式任务 ID 冲突
• 不支持跨项目拆分任务，一条任务描述对应一个项目