todoist-cli

核心用法

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 功能异常，需关注依赖更新

核心功能与用法

todoist-cli 是一个纯文档型 Skill，封装了 Todoist 官方 CLI 工具的完整使用指南。它本身不包含任何可执行代码，而是通过结构化的 Markdown 文档提供命令参考，涵盖任务管理（增删改查、完成/重开、搜索过滤）、项目管理、标签管理、分区管理和评论功能。所有命令均支持 --json 输出以便脚本集成。

典型工作流：

• 快速查看今日任务：todoist
• 添加高优先级任务：todoist add "紧急事项" -P 1 -d "today 5pm"
• 按项目筛选：todoist tasks -p Work --details
• 看板移动：todoist move <task-id> --section "In Progress"

显著优点

1. 零代码风险：T-MD 纯文档分类，无 eval/exec/system 等危险函数，无动态代码加载
2. 功能完整：覆盖 Todoist 核心 API 的几乎所有操作，包括高级功能如分区（Sections）和评论
3. 输出友好：原生支持 JSON 输出，便于与 jq 等工具链集成自动化流程
4. 安装灵活：提供 Homebrew 和 Go 两种安装方式，适应不同环境

潜在局限与风险

1. 依赖外部工具：Skill 本身只是说明书，必须额外安装 todoist 二进制（约 5-15MB），增加供应链复杂度
2. T3 来源风险：维护者为 GitHub 个人开发者（buddyh），非官方 Todoist 团队，需人工确认项目信誉
3. Token 管理负担：用户需自行获取并安全存储 TODOIST_API_TOKEN， Skill 不提供凭证管理指导
4. 无实时同步验证：文档无法检测底层 CLI 与 Todoist API 的版本兼容性

适合人群

• 熟悉命令行的开发者/运维人员，追求键盘驱动的任务管理
• 需要将 Todoist 集成到 Shell 脚本或 CI/CD 流程的自动化场景
• 已使用 Todoist 生态，希望减少上下文切换的现有用户

常规风险

• 供应链风险：通过 brew 或 go install 安装底层工具时，需验证来源未被篡改
• 凭证泄露：API Token 如硬编码在脚本中可能被意外提交到版本控制
• API 限流：高频自动化操作可能触发 Todoist API 速率限制

安全认证结论

扫描评级 A 级（85 分），静态分析通过，隐私合规通过。虽为 T3 个人项目，但因纯文档特性，实际攻击面极小。建议安装底层 CLI 时优先选择官方签名版本，并使用环境变量或密钥管理工具存储 API Token。