Tasks

核心用法

Tasks Skill 通过封装 Todoist API 的 todoist CLI 工具，实现命令行下的任务管理。核心功能包括：

• 列出任务：todoist list 快速查看待办事项
• 添加任务：todoist add "任务内容" --due "日期" 支持自然语言日期解析
• 完成任务：todoist complete <task_id> 标记任务为已完成

显著优点

1. 终端原生体验：无需切换应用，在编码工作流中直接管理任务，显著降低上下文切换成本
2. API 封装简洁：屏蔽底层 OAuth 和 REST 调用，提供类 Unix 风格的管道友好接口
3. 跨平台兼容：Python pip 安装，支持 macOS/Linux/Windows 终端环境

潜在局限

• 依赖外部服务：完全依赖 Todoist 云端 API，离线场景不可用
• Token 管理负担：需手动配置 TODOIST_API_TOKEN 环境变量，多设备同步存在密钥分发问题
• 功能覆盖有限：相比官方 GUI 缺少标签管理、项目归档、协作评论等高级功能

适合人群

• 常驻终端的开发者、运维工程师
• 追求「Inbox Zero」工作流的效率工具爱好者
• 需要将任务管理集成至 CI/CD 或自动化脚本的技术团队

常规风险

| 风险类型 | 说明 |

|---------|------|

| 密钥泄露 | API Token 以明文形式存储在环境变量，共享环境或日志可能意外暴露 |

| 权限过宽 | Token 默认具备完整读写权限，误操作可能导致批量任务删除 |

| 网络依赖 | API 限流或 Todoist 服务中断将直接影响本地 CLI 可用性 |

> 建议通过 direnv 或系统密钥链管理 Token，避免提交至版本控制。

核心用法

Tasks Skill 是一个纯 Markdown 文档型 Skill，用于生成并指导用户使用 Todoist CLI 命令管理任务。主要功能包括：

| 功能 | 命令示例 |

|------|---------|

| 列出待办任务 | `todoist list` |

| 创建新任务 | `todoist add "Review PR #42" --due "2026-02-05"` |

| 标记完成 | `todoist complete <task_id>` |

使用前需配置 TODOIST_API_TOKEN 环境变量，通过 pip install todoist-api-python 安装依赖。

显著优点

• 零代码执行风险：纯文档型设计，无 eval/exec/system 等危险函数，无动态代码加载
• 功能透明可控：仅生成标准化 CLI 命令，用户可审查后再执行
• 依赖官方 SDK：基于 PyPI 官方 todoist-api-python 包，无已知 CVE 漏洞
• 数据最小化：仅要求任务读写所需的 API Token，无过度权限申请
• 合规达标：通过 GDPR/CCPA 数据最小化原则、用户知情权、目的明确性等合规检查

潜在局限

• T3 来源可信度：由个人开发者 xejrax 发布于 ClawHub 平台，非官方或企业级维护
• 功能单一：仅支持基础增删查改，无高级筛选、批量操作、项目协作等功能
• 依赖外部 CLI：实际执行依赖用户本地安装的 todoist 二进制，Skill 本身无运行时
• 无错误处理：文档仅提供命令示例，不包含错误处理或异常情况说明

适合人群

• 已使用 Todoist 并熟悉 CLI 工具的技术用户
• 需要在脚本化工作流中快速生成任务命令的开发者
• 偏好命令行操作、追求简洁效率的任务管理者

常规风险

1. Token 泄露风险：TODOIST_API_TOKEN 需以环境变量形式配置，建议在 .bashrc 或 CI 密钥管理中妥善保管，避免硬编码或日志泄露
2. 权限范围建议：生成 Token 时限制为"任务读写"最小权限，避免使用全功能账户 Token
3. 命令注入可能：虽 Skill 本身无注入风险，但用户若直接将不可信输入拼接到命令行，需自行校验参数
4. 来源可信度：建议在隔离的测试账户首次验证功能，关注 ClawHub 平台用户反馈

安全评级依据

综合评分 95/A 级，静态分析 98 分（无危险函数、无硬编码密钥）、动态分析 95 分（纯 Markdown）、依赖审计 95 分（官方包无漏洞）、隐私合规 95 分（数据最小化）。唯一扣分项为威胁情报 90 分（T3 个人开发者来源）。