核心用法
todoist-cli 是一个面向 Claude 的 Skill 封装层，将开源的 todoist CLI 工具集成到对话工作流中。用户可通过自然语言指令完成 Todoist 全功能操作：快速添加任务（支持自然语言日期解析如 "tomorrow"、"next monday"）、标记完成/重新打开、按优先级/项目/截止日期筛选列表、管理项目与标签分类、以及查看任务评论。所有命令均支持 --json 输出便于脚本化处理，同时提供交互式认证流程。
显著优点
1. 功能完整覆盖：不仅支持基础 CRUD，还涵盖 Kanban 工作流（section 移动）、高级筛选语法、已完成任务历史查询等企业级功能
2. 开发者友好：Go 语言编写的底层 CLI 性能优异，JSON 输出原生支持管道处理（如配合 jq）
3. 安装渠道多元：同时支持 Homebrew 和 Go Modules 安装，适应不同技术栈用户
4. 文档详尽：191 行文档包含完整命令对照表、优先级映射表及多场景示例，降低学习成本
潜在缺点与局限性
1. 外部依赖耦合：必须预装 todoist 二进制文件，首次配置需完成 CLI 安装+API Token 获取两步流程
2. 无离线能力：完全依赖 Todoist 云服务，网络中断时不可用
3. 企业功能缺失：不支持 Todoist Business 的团队管理、工作流自动化等高级特性
4. Token 管理负担：API Token 需用户自行安全存储，无内置密钥托管或轮换机制
适合的目标群体
- 个人效率极客：习惯命令行工作流，追求快速无摩擦的任务录入
- 开发者/技术团队：需要将任务管理集成到开发脚本或 CI/CD 流程
- Todoist 重度用户：已付费使用 Todoist 但希望获得更高效的键盘驱动操作体验
- 自动化爱好者：通过 Claude 实现语音/自然语言驱动的任务管理
使用风险
1. API Token 泄露风险：Token 以环境变量或配置文件形式存储，多用户共享终端时可能被进程监控获取
2. 供应链依赖：底层 CLI 由个人开发者维护，虽开源可审计但无企业级 SLA 保障
3. 数据主权问题：所有任务数据上传至 Todoist 美国服务器，涉及敏感信息的场景需谨慎评估合规性
4. 版本兼容性：Todoist API 升级可能导致 CLI 功能异常，需关注依赖更新