Todoist Skill

Todoist Skill 是什么

这个 Skill 让 AI 通过自然语言管理 Todoist 中的任务和项目。用户可以询问今天或逾期的任务，也可以创建任务、设置截止日期、标记完成并查看项目。它不是独立的待办软件，实际数据仍保存在用户的 Todoist 账户中。

适合处理哪些事情

它适合快速收集待办、查看今天和未来一周的任务、筛选逾期或高优先级事项、创建重复任务，以及按项目和标签查看工作。若团队需要复杂的资源排期、工时核算、审批流程或跨项目报表，还要先确认 Todoist 本身和这个 Skill 的数据范围。

核心能力

• 按今天、明天、逾期、未来七天和优先级筛选未完成任务。
• 用自然语言创建任务，并设置日期、优先级、项目、标签和重复规则。
• 按任务 ID 完成任务，或查看账户中的项目。
• 使用组合筛选条件缩小任务范围。
• 通过附带的 Python 脚本输出 JSON，供其他流程继续处理。

安装与账户要求

使用前需要准备 Todoist API Token，并把它放在运行环境指定的 TODOIST_API_KEY 环境变量中。Token 属于账户凭据，不应写进提示词、聊天记录、代码仓库或任务导出文件。Skill 还可以读取可选的时区设置，用于理解“今天”和自然语言日期。

目录包含 SKILL.md、说明文件、API 参考和 Python 客户端。安装前应查看完整目录，确认脚本只访问预期的 Todoist 接口，并了解当前版本的依赖。

写入操作怎样处理

查询列表和项目属于读取操作，创建、修改、完成和删除任务会改变账户数据。AI 在执行前应先确认目标项目、任务内容、日期和时区。批量操作要先列出匹配范围，再由用户确认。删除比完成更难恢复，没有明确要求时不应把任务永久删除。

筛选和优先级

Skill 支持 today、overdue、tomorrow、7 days、项目、标签和优先级等筛选，也能组合条件。其说明把优先级 1 设为最高、优先级 4 设为最低。自然语言日期最终仍由 Todoist 的解析规则处理，涉及跨时区、月底或重复周期时应读取写入后的任务再次核对。

限制与安全

这个 Skill 依赖网络、Todoist API、有效 Token 和 Python 运行环境。接口版本、筛选语法和权限可能变化，正式自动化前应查看当前说明。任务标题、描述和项目名称可能含有客户、员工或个人生活信息，生成报告或转交其他服务前要控制数据范围。

ClawHub 页面将当前版本标为 MIT-0，但 API 返回的版本元数据没有单独填写许可证字段。使用或再分发前应以下载包中的许可证文件和最新版页面为准。平台展示的安全扫描结果可以作为线索，不能代替自行审查脚本和权限。

常见问题 FAQ

1. 它会替代 Todoist 应用吗？

不会。它提供自然语言和脚本入口，任务仍由 Todoist 服务保存和同步。

2. 必须提供 API Token 吗？

是。当前说明要求通过 TODOIST_API_KEY 环境变量提供 Token，不能把 Token 直接粘贴到对话或提交到仓库。

3. 可以查看今天和逾期任务吗？

可以。它支持 today、overdue、tomorrow 和未来七天等常用筛选。

4. 能创建重复任务吗？

可以使用自然语言日期和重复规则创建，但写入后要核对首次日期、时区和重复周期。

5. 可以按项目和标签筛选吗？

可以使用项目、标签、优先级及组合条件筛选任务。

6. 完成任务和删除任务一样吗？

不一样。完成会保留完成记录，删除可能难以恢复。没有明确要求时应优先完成而不是删除。

7. 能直接批量修改任务吗？

应先列出匹配范围并确认目标。当前说明重点展示单项操作，批量写入还要结合脚本能力和账户权限核验。

8. 时区为什么重要？

“今天”“明天”和重复日期会受时区影响。跨地区使用或自动化运行时应明确时区，并在写入后重新读取任务。

来源与核验说明

本条目根据 ClawHub 上 hail2skins 发布的 Todoist Natural Language 1.0.8 整理，核验了 SKILL.md、凭据要求、Python 客户端范围、写入风险和当前许可证说明。核验日期为 2026 年 9 月 5 日。