核心用法
Todoist Skill 通过 Python 脚本封装官方 API v1，提供完整的任务生命周期管理。核心操作包括：
- 任务查询：支持自然语言过滤器（
today、p1 & overdue、7 days），可按项目、优先级、标签多维筛选 - 任务管理：创建（支持自然语言日期如 "Friday"）、完成、更新、删除全流程操作
- 项目管理：列出所有项目，支持按项目 ID 筛选任务
- 标签系统：多标签支持（
--label work --label urgent），配合@label过滤器使用
显著优点
1. 原生 API 官方集成：直接对接 Todoist 官方 API，数据实时同步，非第三方爬虫方案
2. 自然语言解析：日期识别支持 "tomorrow"、"Friday" 等口语化表达，降低使用门槛
3. 强大过滤语法：支持逻辑运算符 &（与）、|（或），可构建复杂查询如 today & p1 | overdue
4. JSON 结构化输出：所有命令返回标准 JSON，便于程序化解析和链式处理
5. 优先级视觉映射：1-4 级优先级对应红/橙/蓝/灰四色，与 Todoist 客户端保持一致
潜在局限
- 环境变量依赖：必须预配置
TODOIST_API_KEY，无交互式认证流程 - Token 管理风险：长期有效的个人 API token 若泄露可导致全账户数据暴露（无 OAuth 细粒度权限）
- 网络依赖：纯云端服务，离线场景无法使用
- 无本地缓存：每次查询实时请求 API，高频操作可能触发速率限制
- 功能边界：不支持评论区、附件上传、团队协作高级功能（如分配成员）
适合人群
- 已深度使用 Todoist 的 GTD/任务管理实践者
- 需要自动化工作流（结合 cron、其他脚本）的技术用户
- 跨平台数据整合需求（将 Todoist 任务数据导入其他系统）
常规风险
- Token 安全：API key 需妥善保管，避免提交至代码仓库
- 数据误操作：
delete命令不可逆，建议关键操作前执行list确认 - 时区问题：跨时区用户需注意
due.datetime的 timezone 字段解析