mcpField
T
ticktick-cli

ticktick-cli

github.com/flexoid生产力443 次安装37 周前更新
代码仓库

关于 ticktick-cli

ticktick-cli 技能指导 Agent 通过终端命令执行 TickTick 工作流，适合需要在命令行管理任务及相关项目数据的场景。它强调结构化输出、变更前确认标识符，以及写入后验证。

主要功能

  1. 01通过命令行执行 TickTick 操作
  2. 02优先使用 JSON 输出
  3. 03变更前解析名称对应的 ID
  4. 04写入后读取并验证结果
  5. 05危险操作前要求确认

适用场景

  1. 01从终端查询和更新任务
  2. 02按项目 ID 明确指定任务操作范围
  3. 03修改任务日期并核对结果
  4. 04删除项目或标签前取得确认

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/flexoid/ticktick-cli --skill ticktick-cli

安装后在 Claude Code 中输入/ticktick-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
columns.md
folders.md
habits.md
projects.md
setup-and-auth.md
tags.md
tasks.md
troubleshooting.md
user-focus-sync.md

详细介绍

TickTick CLI

使用此技能通过终端命令直接执行 TickTick 工作流，并以确定性方式处理输出。

执行策略

  1. 首先执行用户请求的 ticktick ... 命令。不要预先检查版本或工具是否存在。
  2. 如果因 CLI 缺失而执行失败，请加载 references/setup-and-auth.md 并遵循安装恢复流程。
  3. 如果因身份验证或配置问题而执行失败，请加载 references/setup-and-auth.md，先运行引导式身份验证，再重试原始命令。
  4. 身份验证恢复仅限 CLI。不要自行编写自定义 SDK/Python 令牌交换脚本。
  5. 只有在命令因未知标志/参数或缺少必需参数而失败时，才将 --help 用作恢复措施。

默认设置

  • 优先在所有数据命令中使用 --json，并解析结构化输出。
  • 修改前先将名称解析为 ID；绝不猜测标识符。
  • 每次写入操作都遵循读取 → 修改 → 验证流程。
  • 对任务修改，优先使用显式的 --project PROJECT_ID，以确保行为具有确定性。
  • 使用明确的日期格式（仅日期字段使用 YYYY-MM-DD，定时字段使用 ISO 日期时间）。

安全

  • 安装或更改环境前，必须获得用户明确确认。
  • 除非用户明确要求，否则绝不使用有风险的系统安装标志。
  • 绝不在用户可见的输出中打印机密或令牌。
  • 执行以下破坏性操作前，必须获得用户明确确认：
    • tasks delete
    • projects delete
    • folders delete
    • columns delete
    • tags delete
    • tags merge
    • habits delete

参考索引

仅加载当前操作所需的文件。

评论

支持 Markdown