核心功能
TickTick CLI Skill 是一款面向开发者的命令行任务管理工具，基于官方 Open API v1 构建，提供完整的 TickTick 账号操作能力。
核心用法
认证体系：采用标准 OAuth2 授权码模式，支持浏览器自动回调与无头服务器手动模式。令牌自动刷新机制确保长期可用性，凭证以明文形式存储于 ~/.clawdbot/credentials/ticktick-cli/config.json（权限尝试设置为 700/600）。
任务管理：覆盖任务全生命周期——创建（支持自然语言日期如 "in 7 days"、优先级标记、标签）、查询（按项目/状态过滤、JSON 输出）、更新、完成及废弃（won't do）。特别提供 batch-abandon 批量废弃接口，单次 API 调用可处理多任务。
项目管理：项目列表获取、创建（支持自定义颜色）、重命名与颜色修改，推荐使用项目 ID 而非名称以确保可靠性。
显著优点
- 开发者友好：
--json全局选项支持结构化输出，便于脚本化与 AI Agent 集成 - 智能解析：内置自然语言日期解析器（today/tomorrow/in N days/next monday）
- 批量效率：利用 TickTick 批处理端点减少 API 调用次数
- 自动恢复：令牌过期自动刷新，降低人工干预
潜在局限
- 凭证安全：OAuth 凭证以明文存储，依赖文件系统权限保护
- 速率限制：100 req/min 与 300 req/5min 的严格限流，批量操作易触发
- 功能边界：不支持专注计时、习惯追踪等高级功能；单项目任务上限 500
- ID 依赖：批量废弃等操作要求 24 位十六进制任务 ID，无法直接通过名称操作
适合人群
开发者、自动化工程师、AI Agent 集成场景，以及偏好终端工作流的重度 TickTick 用户。
常规风险
凭证文件若权限配置失败或备份不当可能导致令牌泄露；批量操作前建议通过 lists --json 确认项目存在，避免 "Project not found" 错误。