ticktick-linux

核心用法

TickTick Linux Skill 是一个纯文档型 Agent Skill，通过调用本地安装的 tickrs CLI 工具实现与 TickTick 任务管理平台的集成。该技能提供四大核心功能：任务列表查询（ticktick_list）、任务创建（ticktick_create）、任务完成标记（ticktick_complete）以及项目列表获取（ticktick_projects）。用户可通过自然语言日期（如 "tomorrow at 5pm"）创建任务，支持优先级设置和项目分类管理。

使用前必须完成两项前置配置：运行 tickrs init 进行 OAuth 认证，并设置 TICKTICK_CLIENT_ID 和 TICKTICK_CLIENT_SECRET 环境变量。所有操作均通过本地 CLI 执行，无需网络代码下载或远程脚本执行。

显著优点

架构简洁透明：纯 Markdown 配置，无嵌入式可执行代码，所有功能依赖明确声明的本地二进制文件，安全可审计。

自然语言支持：日期参数支持人性化表达（"next friday"、"today"），降低使用门槛，提升交互体验。

权限最小化：仅申请必要的 bins 和 env 权限，与功能完全匹配，无过度授权风险。

零网络代码执行：所有操作针对本地已安装的 tickrs 工具，无动态代码加载、无远程脚本下载执行。

潜在缺点与局限性

环境依赖严格：必须预先安装 tickrs CLI 工具并完成认证流程，未配置环境则完全无法使用。

平台限制：路径硬编码为 /home/david/.cargo/bin/tickrs，主要面向 Linux/Cargo 安装环境，跨平台兼容性有限。

参数验证外包：Handlebars 模板直接拼接参数，依赖底层 tickrs 工具进行验证，skill 层无预校验机制，存在潜在特殊字符风险。

T3 来源可信度：作者为个人开发者（davidsmorais），非官方或组织维护，长期维护稳定性存疑。

适合的目标群体

• 已使用 TickTick 作为主力任务管理工具的 Linux 开发者
• 熟悉命令行环境、愿意配置 OAuth 认证的技术用户
• 希望通过自然语言与任务管理工具集成的效率追求者
• 对技能透明度有要求、偏好纯文档型配置的安全敏感用户

使用风险

依赖项风险：tickrs 工具的版本和安全性由用户本地环境控制，需确保从官方渠道安装并保持更新。

认证凭证管理：CLIENT_ID/CLIENT_SECRET 以环境变量形式暴露，多用户共享环境时存在凭证泄露风险。

功能边界依赖：参数注入依赖 tickrs 的解析能力，极端输入可能导致命令异常，建议避免在任务标题中使用特殊 shell 字符。