Todoist技能——自然语言任务管理

通过对话管理您的Todoist任务。无需记忆命令行语法——只需用自然语言谈论您的任务。

自然语言示例

该技能能理解对话式请求：

列出任务：

• "我今天有什么任务？"
• "显示我这周的Todoist列表"
• "我有哪些过期任务？"
• "显示优先级1的任务"

添加任务：

• "把'买牛奶'添加到我的待办事项列表"
• "创建一个明天打电话给牙医的任务"
• "我需要在周五前审阅第四季度报告"
• "添加'每周站会'，每周一到期"

完成任务：

• "完成我关于牙医的任务"
• "把牛奶任务标记为已完成"
• "我完成了报告"

管理项目：

• "我在Todoist中有哪些项目？"
• "显示我的工作项目中的任务"

前提条件

• 必须设置TODOIST_API_KEY
• 环境变量，其值为您的Todoist API令牌在此处获取您的令牌：

https://todoist.com/app/settings/integrations/developer

技术用法

# List today's tasks
python3 todoist/scripts/todoist.py list --filter "today"

# Add a task
python3 todoist/scripts/todoist.py add "Buy milk" --due "tomorrow" --priority 2

# Complete a task by ID
python3 todoist/scripts/todoist.py complete "TASK_ID"

# List all projects
python3 todoist/scripts/todoist.py projects

如果您更喜欢CLI命令或需要编写操作脚本，请直接使用Python脚本：

筛选器语法

• 筛选任务时（通过自然语言或CLI）：today
• —— 今天到期的任务overdue
• —— 已过期的任务tomorrow
• —— 明天到期的任务p1、p2、p3、p4
• 7天— 未来7天内到期的任务
• @标签— 带有特定标签的任务
• #项目— 项目中的任务
• 组合使用&（与）和|（或）：今天 & p1

优先级级别

• 1— 紧急（红色）
• 2— 高（橙色）
• 3— 中（蓝色）
• 4— 低（白色/灰色，默认）

功能

• ✅ 自然语言任务管理
• ✅ 时区感知的“今天”筛选
• ✅ 智能筛选（排除已完成的任务）
• ✅ 支持重复任务
• ✅ 完整的Todoist API v1覆盖

响应格式

脚本输出JSON格式以便程序化使用。完整API文档请参见references/api.md。

注意事项

• 该技能会自动过滤已完成的任务
• “今天”使用您的本地时区（如需设置，请配置TZ环境变量）
• 自然语言日期（如“明天”、“下周五”）使用Todoist的内置解析功能