用途:该技能为通过 curl 与 jq 操作 Todoist REST API v2 提供过程性指引,覆盖认证、任务与项目管理、分页、错误处理等。
认证:按顺序解析令牌——先检查环境变量 TODOIST_API_TOKEN,再检查对话上下文中用户提供的令牌,均无则询问用户。校验命令:[ -n "$TODOIST_API_TOKEN" ] && echo "Token available" || echo "Token not set"。所有请求需携带 Authorization: Bearer 头;POST 请求还需 Content-Type: application/json。基础地址为 https://api.todoist.com/rest/v2/。
主要能力:任务、项目、分区、标签、评论的列表、获取、创建、更新、删除等操作,以及关闭/重开任务、归档/取消归档项目、重命名或移除共享标签。任务支持 project_id、section_id、label、filter 等筛选参数,创建字段含 content、description、priority、due_string、due_date、due_datetime、labels、assignee_id、duration 等。
确认要求:执行任何破坏性操作(删除、关闭、更新、归档)前必须向用户确认,一组相关操作确认一次即可;只读 GET 操作无需确认。
分页与错误:部分接口返回 next_cursor,需循环携带 cursor 参数拉取全部数据;HTTP 状态码涵盖 200、204、400、401、403、404、429 与 5xx。写入操作可加入 X-Request-Id 头(最长 36 字符)实现幂等重试。
限制:REST API v2 的 /tasks 仅返回活动任务,已完成任务需改用 Sync API 或统一 API v1 的完成记录接口;更多细节参见 references/completed-tasks.md 与 references/filters.md。未提供收费、价格等信息。