用途：在 Todoist 中执行任务与项目操作，包括捕获、分诊、批量编辑和结果核对。日常操作优先使用官方 CLI，仅在特定集成或已确认 CLI 存在缺口时使用公开 API，不自行维护完整客户端，也不擅自切换用户账号或连接。
主要能力：解析账号/工作区、项目、分区、个人与共享标签等上下文；保留不透明字符串 ID；支持任务添加、查看、编辑、完成、移动、评论、删除及批量操作；支持完成工作报告与分页处理。
使用方式：优先使用已授权的 Todoist 连接器；否则检查 td --version、td --help、td auth status。官方包为 @doist/todoist-cli，可执行文件为 td。安装与认证会改变主机/账号状态，仅在获授权时进行。凭据应存入操作系统凭据存储，不要放在命令参数、报告或仓库中；TODOIST_API_TOKEN 会覆盖已存凭据，怀疑账号或权限异常时可检查其是否存在，但不要打印其值。只读工作优先使用只读 OAuth。使用前阅读具体子命令帮助，优先使用结构化输出，不要解析人类可读表格或假设各命令标志一致。Doist 维护自己的 CLI 技能（td skill install universal 或相应 agent 目标），可用于完整命令语法，安装为可选。
示例：td project list --json；td task list --project "Work" --json；td task view TASK_ID --json；td add "Email Chris tomorrow at 09:00 #Work @follow-up p2"。添加后需读回任务，核对项目、标签、解析日期时间、时区与重复规则。API 优先级编号与用户可见的 p1 记法不同，需验证映射。编辑时先读当前状态，应用变更后读回受影响字段。符合请求时优先完成而非永久删除；完成重复任务的一次发生与结束整个系列是不同操作，需检查返回的下次到期日。
批量编辑与恢复：批量关闭/移动/评论/删除前，冻结明确的 ID 集合与拟议变更，预览后应用该集合，不要重新运行变化的筛选器。维护结果台账，区分确认成功、确认失败与未知结果；写入后超时属于未知，不是未发生，重试前先对账，不要重启整个部分完成的批次或重新生成去重 ID。
报告与集成：完成工作报告需定义时区与区间，区分完成时间与到期日；遵循所有返回游标，否则标注结果不完整；不要把分页大小当作总数。Sync API、附件、模板、归档资源或迁移工作，需先确认实时端点/SDK 契约再使用参考。旧的自定义 Python CLI 及其标志已移除，无兼容层。
限制：不要仅凭命令示例声称连接、写入或报告成功。已安装帮助与当前端点文档是精确语法的权威。资料未提供具体收费、价格、平台支持范围等信息。