使用说明
Claude Code的todoist插件
令牌高效Todoist for Claude Code：由
官方的 td CLI，加上可选的工作流技能——会话捕获、
日常惯例和收件箱分类——适应你的结构，而不是
强加一个。
快速开始
在克劳德代码中：
/plugin marketplace add jackhutson/todoist-mcp-plugin
/plugin install todoist@todoist-marketplace
/todoist:setup
安装程序检查/安装 td CLI(npm install -g @doist/todoist-cli),
浏览浏览器OAuth（存储在操作系统密钥环中的令牌），运行
td doctor，并提供只读允许列表 td 命令如此日常使用
不会触发权限提示。
技能
| 技能 | 调用 | 它的作用 |
|---|---|---|
todoist |
自动 | 精简td命令界面以执行任何任务操作 |
/todoist:setup |
手动 | 安装、身份验证、健康检查、权限分配列表 |
/todoist:capture |
手动 | 将此会话的未完成部分收集到任务中——这就是在您的编码代理中使用Todoist的原因 |
/todoist:daily |
手动 | 晨间演练：分诊过期→ 捕获→ 优先处理→ sort → 计划 |
/todoist:triage |
手动 | 收件箱零处理器，一次一个项目，一批更改 |
工作流技能懒散地学习你的偏好——只问一个问题
当第一次需要时，然后坚持
~/.config/todoist-plugin/preferences.md （简单标记；自由编辑）。
建筑学
根据输出大小选择两条执行路径：
- 内联
td--有界操作直接在主上下文中运行。 todoist-agent--读取带有帐户大小的刻度（全扫描， 多项目扫描）在返回≤30行的子代理内运行 消化。详细的输出永远不会到达您的上下文窗口。
代币数学
| 空闲 | 已触发 | |
|---|---|---|
| 此插件（操作技能） | ~110个令牌 | ~855个令牌 |
| 此插件（全部5个技能+代理） | ~870个令牌 | 每次调用付费 |
官方 td 技能 |
约120个代币 | 约6.8k个代币 |
| Doist MCP服务器（始终加载） | ~2.5k令牌/消息 | -- |
Idle=每个会话都加载了frontmatter；触发=完整技能体。
每项技能的数字是字符/4，通过硬CI上限强制执行
scripts/check-skills.mjs.插件总行是官方的
claude plugin details 估计值——其标记器计数高于
chars/4（操作技能：约1.3k vs约855次触发），因此将chars/4视为地板。
为什么不是官方 td 技能？
td skill install claude-code 安装Doist参考手册：~6800
涵盖完整CLI的令牌，包括开发人员应用程序、计费、备份，
以及帮助中心搜索。此插件的操作技能可管理约20个命令
任务工作流实际使用并依赖于 td <command> --help 为了
长尾——CLI是自文档化的。CI漂移检查差异 tds
帮助输出快照，这样精心策划的表面就不会悄无声息地腐烂。
信用到期：不可信内容规则，优先级映射gotcha， 快速添加指导是根据Doist的技能（MIT）改编的。
需求
- 支持插件的Claude代码
- Node.js 20+（用于td CLI）
- Todoist帐户（免费或专业版）
从v1迁移
v1封装了Doist MCP服务器。v2将其替换为 td CLI：
跑 /todoist:setup，然后删除旧的 todoist MCP连接
/mcpv1技能(todoist-tasks, todoist-sync)消失了；这个
todoist 操作技能涵盖了这两个方面。
许可证
麻省理工学院
