核心用法
Todoist 任务可见性 Skill 是一套基于 Todoist API 的 Shell 脚本工具集，通过创建状态分区（Section）实现看板式任务管理。核心组件包括：todoist_api.sh 提供通用 API 封装，sync_task.sh 负责任务创建与状态流转，add_comment.sh 支持进度评论追加。用户通过环境变量配置 API Token 和项目/分区 ID 后，即可在命令行完成从任务创建、状态更新到进度记录的全流程操作。
显著优点
1. 可视化状态管理：强制使用 🟡🟠🟢 三色 Emoji 标记，直观区分任务阶段
2. 低代码集成：纯 Shell 实现，依赖仅 curl + jq，无复杂运行时
3. 原生评论支持：进度日志直接写入 Todoist 评论，形成完整任务时间线
4. API 抽象合理：三层脚本架构（通用/同步/评论）职责清晰，易于扩展
潜在缺点与局限性
- 配置门槛高：需手动获取 API Token、项目 ID、三个 Section ID，共 5 个环境变量
- 无状态缓存：每次操作均调用 API，频繁使用易触发速率限制
- 单向同步：仅支持写入，无法自动同步 Todoist Web 端的原生状态变更
- Section 硬依赖：要求用户在 Todoist 中预创建三个特定命名的 Section，否则功能失效
适合人群
- 命令行重度用户和开发者
- 已使用 Todoist 但需要看板视图补充的敏捷团队
- 希望将任务管理与 CI/CD、自动化脚本集成的技术团队
常规风险
- Token 泄露风险：API Token 以明文环境变量存储，建议配合
direnv或密钥管理工具 - 误操作覆盖：update 操作无二次确认，需确保 task ID 准确
- API 配额消耗：免费版 Todoist API 有每日调用限制（约 450 次）