Todoist 技能用于通过 Todoist REST API v2 进行任务管理。当用户提到“Todoist”“我的任务”“创建待办”或询问 Todoist 项目时,可使用本技能。
用途 本技能面向需要通过 API 操作 Todoist 任务管理数据的场景,覆盖项目、任务、分区、标签和评论等核心对象。
主要能力 项目:获取全部项目、获取单个项目、创建项目、更新项目、删除项目。 任务:获取活动任务、按项目获取活动任务、获取单个任务、创建任务、更新任务、完成任务、重新打开任务、删除任务。 分区:获取分区、按项目获取分区、创建分区。 标签:获取标签、创建标签。 评论:获取任务评论、创建评论。
使用方式 所有请求通过 curl 调用 https://api.todoist.com/rest/v2/ 下的对应端点,并在请求头中携带 Authorization: Bearer $TODOIST_TOKEN 进行认证。创建或更新操作需将 JSON 请求体写入 /tmp/todoist_request.json,再通过 -d @/tmp/todoist_request.json 发送。
排查连接问题 若请求失败,可运行 zero doctor check-connector --env-name TODOIST_TOKEN 或 zero doctor check-connector --url https://api.todoist.com/rest/v2/projects --method GET 进行诊断。
关键约定 优先级数值为 1(普通)到 4(紧急),数字越大优先级越高。截止日期支持自然语言,例如“tomorrow”“every monday”“Jan 15 at 3pm”。任务 ID 均为字符串,应使用列表或创建响应中返回的值。标记任务完成应使用 /close 端点,而不是删除。删除项目或任务成功时返回 204 状态码。标准速率限制适用,应避免快速连续请求。
适用场景 适用于需要以编程方式管理 Todoist 项目、任务、分区、标签和评论的自动化流程或集成场景。
限制 本技能依赖 TODOIST_TOKEN 环境变量进行认证;未提供令牌时无法调用。文档未提供除标准速率限制外的具体配额数值,也未提供收费、价格或平台支持等额外信息。