TickTick 技能用于管理 TickTick 任务与项目,通过 {baseDir}/scripts/tt.sh 脚本调用 TickTick API,完整 API 参考见 references/api.md。
用途 该技能适用于用户要求添加、创建或捕获任务或待办事项;列出、显示或回顾待处理任务;完成或勾选任务;以及管理 TickTick 中的任务与项目等场景。
认证方式 使用 TICKTICK_TOKEN 环境变量,值为 TickTick 个人访问令牌(以 tp_* 开头),直接作为 Bearer 令牌使用,无需 OAuth 流程。可从密钥管理器或 shell 配置文件中加载。
时区处理 截止日期会自动附加本地 UTC 偏移。可通过 TICKTICK_UTC_OFFSET(例如 -03:00)覆盖,并可选使用 TICKTICK_TIMEZONE(IANA 名称,例如 America/Buenos_Aires)。
收件箱 每个用户的收件箱项目 ID 会从 API 自动发现。设置 TICKTICK_INBOX_ID 可跳过额外的查询调用。
快速参考 TT="bash {baseDir}/scripts/tt.sh"
命令 列出项目:$TT projects
列出任务: $TT tasks # 收件箱(默认) $TT tasks --project "Work" # 按名称 $TT tasks --project <projectId> # 按 ID
添加任务: $TT add "Buy tennis grip" $TT add "Call accountant" --priority high --due "2026-02-20T10:00:00" $TT add "Draft email" --project "Work" --priority med --notes "Reply to client" $TT add "Review PR" --tag "work,code" 优先级取值:none | low | med | high
完成任务: $TT complete <taskId> --project <projectId>
收件箱任务:--project 标志可选(默认为收件箱)
更新任务: $TT update <taskId> --project <projectId> --priority high $TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"
删除任务: $TT delete <taskId> --project <projectId>
管理项目: $TT add-project "Tennis" # 创建新列表 $TT add-project "Work" --color "#FF5733" $TT delete-project <projectId>
工作流程 快速捕获——如果未指定项目,任务会进入收件箱。 查找 taskId——运行 $TT tasks 或 $TT tasks --project X,从输出中复制 id。 查找 projectId——运行 $TT projects,复制 id。
显示格式 向用户展示任务时,按以下格式: 📋 Inbox — 3 pending
○ [HIGH] Call accountant — due Feb 20 ○ [MED] Review analytics ○ Buy tennis racket grip
排序方式:先按优先级(高在前),再按截止日期。除非被要求,否则隐藏已完成任务。
适用场景与限制 该技能适用于通过命令行脚本管理 TickTick 任务与项目的场景,依赖 TICKTICK_TOKEN 环境变量进行认证。关于收费、价格、平台支持范围等更多信息,资料中暂未提供。