todoist-setup（Todoist集成设置）Skill 有什么用？

Todoist集成设置Skill：把 Todoist 与 Dex 接起来，实现双向任务同步

• 一句话定位：这是一套「连接配置型」技能，把已有 Todoist 账户接入 Dex 工作台，让任务在两个系统之间双向流动。
• 核心能力：在 Dex 里建任务，自动出现在 Todoist；在 Todoist 里勾掉任务，Dex 会在下一次每日计划中同步到完成状态。
• 不需要写代码：全程由对话引导完成，用户只需准备一个 Todoist API 令牌，按提示粘贴即可。
• 可插拔增强：连接后自动升级 /daily-plan、/triage、/process-inbox、/week-review 四个既有技能的能力。
• 隐私可控：API 密钥保存在本地配置文件（已 gitignore），只同步任务标题、优先级与完成状态。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：Todoist集成设置Skill 技能英文名：todoist-setup 技能ID：11894

它要解决的问题非常具体：很多人的任务分散在两个地方——Todoist 里躺着生活琐事和长期清单，Dex 里放着当天的工作计划，每天两边来回切、手动搬运，最后要么漏掉，要么干脆放弃其中一个。这个技能的价值就在于「一次配置，长期省心」：把 Todoist 作为外部任务源接入 Dex，让两边在同一套节奏里运转。

安装前提

• 已经有一个可运行的 Dex 环境，并且知道自己的配置文件位置（System/integrations/config.yaml 与 .mcp.json）。
• 有一个 Todoist 账户，能进入「设置 → 集成 → 开发者」页面拿到 API 令牌。
• 本地具备运行 npx 的环境（MCP 服务器通过 npx -y todoist-mcp-server 启动）。

一键安装的入口与步骤

1. 触发技能：在 Dex 中直接输入 /todoist-setup。如果你是在做整体集成配置，在 /integrate-mcp 流程中提到 Todoist，也会自动引入本技能。
2. 确认开始：技能会先说明「连接后能做什么、需要你准备什么、大约花费 2 分钟」，等你确认后再往下走。
3. 粘贴 API 令牌：按提示打开 Todoist → 设置 → 集成 → 开发者，复制那串约 40 位的十六进制 API 令牌，粘贴到对话里。
4. 写入 MCP 配置：技能会把 todoist-mcp 连接器写入你的 .mcp.json（也可以借助 /dex-add-mcp 技能或手动编辑），形如：

{
  "todoist-mcp": {
    "command": "npx",
    "args": ["-y", "todoist-mcp-server"],
    "env": { "TODOIST_API_KEY": "<你的API密钥>" }
  }
}

5. 重启 MCP 服务：配置变更需要重启 MCP 服务器才会生效。
6. 连接自检：技能会调用 Todoist 项目列表接口（https://api.todoist.com/rest/v2/projects）验证密钥是否可用。

如何验证是否生效

• 能看到自己的 Todoist 项目列表被成功列出，说明连接打通。
• System/integrations/config.yaml 中出现 todoist: 段落且 enabled: true。
• 在 Dex 中新建一个任务，去 Todoist 对应项目里查看是否出现同名任务。
• 反之，在 Todoist 勾掉一个任务，下一次 /daily-plan 时该任务应被识别为已完成。

具体的命令参数、依赖版本、安装渠道等细节，以官方说明为准。

2. 该技能的主要功能和特点

• 双向任务同步：同步实体为「任务」，方向为双向。Dex 创建 → 推送 Todoist；Todoist 完成 → Dex 下次每日计划时获取。
• 自然接触点触发，而非后台轮询：同步发生在 /daily-plan、任务创建、/triage 等接触点上，不常驻后台运行，减少无谓请求与意外覆盖。
• 四个既有技能的能力增强：
  • /daily-plan：把今日到期的 Todoist 任务与 Dex 任务合并成一份计划，外部任务带 [Todoist] 标签标明来源。
  • /triage：处理新项目时，可以路由到 Dex、Todoist 或两者。
  • /process-inbox：处理收件箱捕获项时，提供同样的路由选项。
  • /week-review：展示跨系统（Dex + Todoist）的完成统计，避免只看到一半的成果。
• 可调的三档信任级别：confirm_each（同步前先预览，推荐新手）、autonomous（静默自动同步）、read_only（只从 Todoist 拉入、不回推）。
• 项目映射灵活：可以所有 Dex 任务统一进一个 Todoist 项目（最简单），也可以按支柱（如交易支持、思想领导、产品反馈）分别映射到不同项目。
• 防重与防循环机制：由 Dex 创建的任务在 Todoist 描述中携带 [dex:task-ID] 标记，拉取时自动跳过，避免来回镜像出重复任务。
• 各存副本、互不阻塞：两个系统各保留一份自己的数据，一方离线另一方照常工作。
• 隐私边界清晰：只同步任务标题、优先级和完成状态；API 密钥本地存储且不进入版本库，不与第三方共享数据。

和普通「手动搬运」比强在哪：普通做法是复制粘贴标题、手动改截止日期、手动勾完成，一天至少三五分钟；这个技能把这些动作压到「同步接触点自动发生」，并且附带了跨系统的周回顾统计，这是手动操作无法自然获得的信息。

3. 如何使用该技能？

首次配置（跟着对话走完 9 步）

1. 检查现有连接：技能先读 config.yaml，若有 todoist: 且 enabled: true，会用已存的密钥测试连通性；健康则直接跳到「重新配置」，不健康则重新走流程。
2. 了解设置内容：确认你清楚要准备什么、会花多久。
3. 获取 API 令牌：Todoist → 设置 → 集成 → 开发者 → 复制 API 令牌，粘贴到对话。
4. 添加 MCP 服务器：自动写入 .mcp.json，然后提醒你重启 MCP 服务器。
5. 测试连接：成功则列出你的项目；失败会提示三个常见原因（密钥没复制全、前后有空格、需重新生成），最多重试 2 次，之后可选择稍后再来。
6. 选择默认项目：所有任务进一个项目，或按支柱映射多个项目。
7. 选择同步自主性：
   • 「先给我看」→ trust_level: confirm_each
   • 「保持同步」→ trust_level: autonomous
   • 「仅拉入」→ trust_level: read_only
8. 保存配置：更新 System/integrations/config.yaml 的 todoist: 段，其余集成配置保持不变。
9. 查看能力瀑布：技能会逐条告诉你哪些既有技能变聪明了、新增了什么超能力、读写与隐私各自怎么表现。

日常调用示例

示例一：让今日计划合并外部任务

/daily-plan

输出预期：一份合并后的今日清单，其中来自 Todoist 的条目带 [Todoist] 标签，Dex 自有条目正常显示。

示例二：新任务该进哪个系统

/triage 需要给客户补一份接口文档，周五前

输出预期：技能给出路由选项——只进 Dex、只进 Todoist、或两边都建（两者会在后续接触点保持一致）。

示例三：调整映射或换密钥

再次运行 /todoist-setup，即可查看当前项目映射与信任级别，并选择更新映射、更改同步行为、更新 API 密钥或断开连接。注意：已存在的任务不会因映射变更而移动，只有新任务使用新映射。

断开连接

运行 /todoist-setup 选择断开，配置会被改为 enabled: false。两边已有的任务都保持原样，只是不再同步。

4. 同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
todoist-setup（本技能）	Dex × Todoist 的双向任务同步配置器	双向任务同步、项目/支柱映射、三档信任级别、增强每日计划与周回顾	低：对话式引导，粘贴 API 令牌即可，约 2 分钟	已用 Dex 做每日计划、同时依赖 Todoist 管清单的个人	优势：与每日计划/分类/周回顾深度联动，密钥本地保存；不足：同步只在接触点发生，非实时后台同步
Zapier / Make 等通用自动化平台	跨应用工作流自动化	触发器 + 动作编排，可连数百种服务	中高：需自行设计触发条件与字段映射，常涉及订阅费用	规则稳定的批量流转，如「新增任务自动建日历事件」	优势：连接面广、可做复杂分支；不足：不为任务管理场景定制，容易产生重复项，需自己处理去重
滴答清单 / Things 3 等任务应用自带集成	单一任务应用内部的生态联动	日历订阅、系统提醒、部分第三方插件	低：应用内开关	只在一个应用内管理全部任务	优势：体验统一、无需配置；不足：跨系统双向同步能力弱，无法把外部 AI 工作台纳入同一节奏
纯手动双系统维护	人工复制粘贴	无	零门槛	任务量极少、临时过渡	优势：不依赖任何配置；不足：易漏、易重复、耗时间，且无法得到跨系统统计

选型建议：如果你的核心工作流已经跑在 Dex 的每日计划上，又不想放弃 Todoist 的移动端体验，本技能是最贴合的；如果你需要的是「任意应用之间的复杂自动化」，通用自动化平台更合适，但记得自己加去重标记。

5. 该技能的典型应用场景与实际体验情况

场景一：每天开工前的统一视图（个人贡献者 / 独立开发者） 痛点是「今天到底要做什么」需要开三个 App 才能拼出来。使用方式很简单：早上第一件事 /daily-plan，Todoist 里今天到期的琐事会被自动合并进来，并带 [Todoist] 标签标明来源。实际体验：上手几乎无门槛，配置一次之后每天零操作；需要注意的是，因为同步不是后台常驻，刚在 Todoist 加的任务要等到下一次接触点才会出现，不要误以为没生效。

场景二：新任务分流的决策疲劳（团队负责人 / 项目经理） 痛点是「这件事该记在哪」每次都要想一遍。用 /triage 时技能会直接给出「Dex / Todoist / 两者」的路由选择，/process-inbox 处理收件箱捕获项时同理。实际体验：把模糊判断变成了一个三选一，收件箱清空速度明显变快；建议把长期跟进类放 Todoist、当天要推进的放 Dex，映射关系想清楚后几乎不再犹豫。

场景三：跨系统的周回顾（需要向上汇报的职场人） 痛点是周报里只统计一个系统，成果被低估。运行 /week-review 可以看到 Dex + Todoist 的合并完成统计。实际体验：这是很多人配置后最惊喜的一环——原来「做完了但没记录」的事情被补了回来；注意确保两边任务标题可读，否则统计出来是一堆缩写。

场景四：多项目并行的映射管理（同时推进多条业务线的人） 把 Dex 的支柱（如交易支持、思想领导、产品反馈）分别映射到不同 Todoist 项目，任务自动落到正确的清单里。实际体验：初次映射需要想清楚，中途改名 Todoist 项目会导致任务落到收件箱；另外修改映射只影响新任务，历史任务需要手动整理。

通用注意事项：Todoist 的速率限制约为每分钟 450 次请求，适配器对 429 响应做了自动重试，正常使用基本感知不到；若出现重复任务，优先检查 [dex:task-...] 标记是否存在。

6. 该技能能为用户带来的价值

• 时间收益：把每天多次的「复制—切换—粘贴—勾选」压缩成一次配置。即使按每天节省 5 分钟计算，一个月也能回收两小时以上的注意力，而这些时间原本消耗在无价值的搬运上。
• 降低门槛：不需要写同步脚本、不需要理解 OAuth 或 Webhook，一个 API 令牌 + 一段对话就完成接入，把「集成」这件事从工程任务降级为产品操作。
• 减少遗漏：今日计划天然合并了外部到期任务，避免「记在 Todoist 里但今天必须做」的事项被无视。
• 信任可控：三档信任级别让使用者可以先用「先给我看」观察一段时间，确认行为符合预期后再切换到「保持同步」，兼顾自动化与安全感。
• 长期价值：跨系统的周回顾与完成统计会随着使用时间积累越来越有价值，形成一份不依赖于单一工具的成果档案；同时因为两个系统各存副本，你也不会被某个工具锁定。

7. 常见问题 FAQ

Q1：怎么安装这个技能？需要准备什么？ 在 Dex 中运行 /todoist-setup 即可启动引导，也可以在 /integrate-mcp 流程中提及 Todoist 触发。准备两样东西：可用的 Dex 环境和一个 Todoist API 令牌（Todoist → 设置 → 集成 → 开发者），全程约 2 分钟。

Q2：收费吗？ 本技能本身是 Dex 的集成配置技能，其收费情况取决于 Dex 与 Todoist 各自的订阅方案，本技能未定义额外计费项，具体以官方说明为准。Task 同步不产生额外费用。

Q3：同步是实时的吗？我在 Todoist 加了任务为什么 Dex 里没出现？ 不是实时后台同步。同步只发生在自然接触点（/daily-plan、任务创建、/triage 等），所以刚在 Todoist 加的任务通常会在下一次每日计划时被拉入。这是为降低请求量和避免冲突而做的设计取舍。

Q4：我的数据安全吗？API 密钥会不会泄露？ 密钥保存在本地 System/integrations/config.yaml 中，且该文件已被 gitignore；技能只同步任务标题、优先级和完成状态，不额外存储任务内容或笔记，也不与第三方共享 Todoist 数据。

Q5：适合谁用？和通用自动化平台怎么选？ 适合「已经在用 Dex 做每日计划、同时离不开 Todoist」的个人用户，尤其是需要跨系统做周回顾的人。如果你要做的是任意应用之间的复杂多步自动化，Zapier / Make 之类更合适；如果你只想在一个应用里管任务，用任务应用自带的集成即可，不必引入这套配置。