Todoist Natural Language

核心用法

Todoist Skill 实现了自然语言驱动的任务管理，用户可通过对话式指令直接操控 Todoist 账户。支持四大核心场景：列表查询（今日任务、逾期项、优先级筛选）、任务创建（支持自然语言日期解析与循环任务）、任务完成（模糊匹配任务内容标记完成）、项目管理（查看项目及项目内任务）。系统同时保留底层 CLI 接口，满足脚本化需求。

显著优点

• 零学习成本：完全自然语言交互，无需记忆 filter 语法或命令参数
• 智能上下文理解：自动识别 "tomorrow"、"next Friday" 等模糊时间，支持循环任务设置
• 精准过滤：内置时区感知的 "today" 计算，自动排除已完成任务，支持多条件组合过滤（today & p1）
• API 完整性：覆盖 Todoist API v1 全功能，包括标签、优先级、项目归属等元数据
• 双模操作：对话式交互与 CLI 脚本无缝切换，JSON 输出便于自动化集成

潜在缺点与局限性

• 环境依赖：必须预置 TODOIST_API_KEY，无令牌则完全不可用
• 无离线能力：纯云端 API 调用，网络中断即失效
• 模糊匹配风险："complete my task about the dentist" 依赖关键词匹配，同名任务可能误操作
• 功能边界：不支持任务编辑（修改标题/日期/优先级）、子任务管理、协作成员操作等进阶功能
• 时区陷阱：依赖 TZ 环境变量，配置错误会导致 "today" 判定偏差

适合人群

• 追求「说人话就能管任务」的效率工具用户
• 已深度使用 Todoist 但厌倦手动点击的现有用户
• 需要将任务管理嵌入自动化工作流的技术用户（配合 CLI/JSON 输出）

常规风险

• 令牌泄露：API key 以环境变量存储，多用户系统存在横向读取风险
• 误操作不可逆：自然语言指令解析错误可能创建错误任务或完成错误项，且 Todoist 回收站恢复需手动操作
• 数据隐私：所有任务内容经第三方服务（或自托管服务）中转至 Todoist 服务器，敏感任务存在泄露链路

核心用法

Todoist Skill 提供自然语言驱动的任务管理能力，用户无需记忆CLI语法即可通过对话完成日常任务操作。支持列出今日/本周/逾期任务、按优先级筛选（p1-p4）、添加带截止日期的任务、标记完成，以及项目管理。技术用户也可直接使用Python脚本进行程序化操作。

自然语言示例：

• "What tasks do I have today?" — 列出今日任务
• "Add 'buy milk' due tomorrow with priority 2" — 添加高优先级任务
• "Complete my task about the dentist" — 智能匹配并完成任务

CLI备用方案：

python3 todoist/scripts/todoist.py list --filter "today & p1"
python3 todoist/scripts/todoist.py add "Review Q4 report" --due "Friday"

显著优点

1. 零依赖极简架构：仅372行可执行代码，纯Python标准库实现，无第三方包依赖，彻底消除供应链攻击风险
2. S级顶级安全认证：六项安全维度全部满分通过，静态/动态分析均无漏洞发现
3. 自然语言理解：支持"tomorrow"、"next Friday"、"every Monday"等口语化时间表达，降低使用门槛
4. 企业级API合规：仅连接官方Todoist API（api.todoist.com），TLS 1.2+加密传输，符合GDPR/CCPA隐私法规
5. 安全密钥管理：API令牌强制从环境变量读取，无硬编码风险，支持时区自定义（TZ变量）

潜在缺点与局限性

• 功能边界：仅覆盖任务CRUD和项目管理，不支持Todoist原生标签管理、评论、附件上传等进阶功能
• 自然语言模糊性：复杂任务描述可能导致意图识别歧义，建议关键操作后人工确认
• 网络依赖：完全依赖Todoist云服务，离线场景无法使用（对比本地待办工具如Taskwarrior）
• API速率限制：高频操作可能触发Todoist免费版API配额限制
• 维护状态：个人开发者项目（hail2skins），无商业支持SLA保障

适合人群

• 效率工具用户：已使用Todoist生态，希望通过自然语言快速管理任务
• 安全敏感型用户：对第三方依赖极度谨慎，需要可审计的极简代码库
• Claude Code/OpenClaw用户：寻求原生集成的任务管理增强能力
• 隐私合规场景：需满足GDPR/CCPA要求的个人或小型团队

常规风险

• API密钥泄露：若环境变量配置不当（如写入shell历史记录），可能导致令牌暴露；建议配置于~/.bashrc并设置权限600
• 时区配置遗漏：未设置TZ环境变量时，"today"可能基于UTC时间而非本地时间
• 任务内容隐私：任务数据上传至Todoist云端，敏感信息应避免明文存储
• 版本兼容性：依赖Todoist API v1，未来官方API变更可能导致功能中断