基于 Rube MCP 与 Composio 实现 TickTick 任务自动化：awesome-claude-skills 实战指南

本篇技术指南围绕 awesome-claude-skills 仓库中的 ticktick-automation Skill 展开，讲解如何通过 Rube MCP（Composio 提供的 MCP 网关）让 Claude 直接操作 TickTick——创建任务、管理清单、完成待办等。你将掌握从 MCP 端点配置、OAuth 连接建立、工具发现到多工具批量执行的一整套可复用的自动化工作流模式，并了解这套模式在本仓库 78 个 SaaS 自动化 Skill 中的通用地位。

Skill 定位与仓库角色

ticktick-automation 是仓库 composio-skills/ 目录下"App Automation via Composio"系列中的一个预构建 Skill。该系列在 README.md 中被描述为：基于 Rube MCP（Composio）为 78 个 SaaS 应用提供的预构建工作流 Skill，每个 Skill 都包含工具序列、参数指引、已知陷阱和快速参考表，且工具 slug 全部来自 Composio API 的真实发现结果。

该 Skill 的元数据（YAML frontmatter）如下：

---
name: ticktick-automation
description: "Automate Ticktick tasks via Rube MCP (Composio). Always search tools first for current schemas."
requires:
  mcp: [rube]
---

关键信息有两个：其一，Skill 依赖一个名为 rube 的 MCP 服务器，说明它不是一个自带工具的独立 Skill，而是建立在 MCP 工具层之上的行为编排层；其二，description 中反复强调 "Always search tools first"，这是整套工作流最重要的纪律——工具的 schema 会随 Composio API 演进而变化，任何硬编码的调用都是不可靠的。

前置条件

在运行任何 TickTick 自动化流程之前，需要满足以下三个前置条件：

1. Rube MCP 已连接：确保 RUBE_SEARCH_TOOLS 工具可用（它是验证连接是否就绪的探针）；
2. TickTick 连接处于 ACTIVE 状态：通过 RUBE_MANAGE_CONNECTIONS 以 ticktick 为 toolkit 建立的有效连接；
3. 先搜索后执行：每次执行前必须先调用 RUBE_SEARCH_TOOLS 获取当前的工具 schema，禁止跳过。

这与仓库 connect/SKILL.md 描述的架构一脉相承：Composio 负责"连接"（OAuth 自动处理）与"工具路由"，Skill 则负责定义"行为流程"。三者分工明确——MCP 负责访问通道，工具负责具体动作，Skill 负责编排顺序与防护规则。

环境搭建：接入 Rube MCP 并建立 TickTick 连接

添加 Rube MCP 服务器

获取 Rube MCP 的方式极其简单：在 Claude 客户端（Claude Code、Claude.ai 或任何支持 MCP 的客户端）的 MCP 服务器配置中，添加端点 https://rube.app/mcp 即可。不需要任何 API Key——只需添加端点即可直接使用，这是该方案区别于传统 Composio SDK 集成的核心优势。

建立 TickTick 连接（4 步）

1. 验证 Rube MCP 可用：确认 RUBE_SEARCH_TOOLS 有响应；
2. 发起连接：调用 RUBE_MANAGE_CONNECTIONS，toolkit 指定为 ticktick；
3. 完成授权：如果连接状态不是 ACTIVE，跟随返回的授权链接（OAuth 页面）完成 TickTick 账号授权；
4. 确认状态：在运行任何工作流之前，确认连接状态显示为 ACTIVE。

这一"连接-授权-确认"三段式流程与仓库 connect/SKILL.md 的 Auth Flow 一致：首次使用某应用时返回授权链接，用户点击授权并确认后，连接会持久化保存，后续无需重复授权。

工具发现：RUBE_SEARCH_TOOLS

在执行任何 TickTick 操作之前，必须先用 RUBE_SEARCH_TOOLS 发现可用工具。Skill 给出了标准调用示例：

RUBE_SEARCH_TOOLS
queries: [{use_case: "Ticktick operations", known_fields: ""}]
session: {generate_id: true}

一次成功的调用会返回四类关键信息：

• 可用的工具 slug（tool slugs）：后续 RUBE_MULTI_EXECUTE_TOOL 的 tool_slug 字段直接取自这里；
• 输入 schema：每个工具的参数结构、字段名与类型，是构造 arguments 的唯一权威依据；
• 推荐的执行计划：针对目标 use case 的推荐工具组合与调用顺序；
• 已知陷阱（known pitfalls）：该工具特有的易错点提示。

queries 支持按具体任务细化 use case（例如"为今天的日程创建 TickTick 任务""查询本周未完成事项"），session 中的 generate_id: true 用于在工作流启动时为会话生成唯一 ID，为后续步骤复用会话做准备。

核心工作流模式

Skill 将 TickTick 自动化收敛为一个三步工作流模式，任何任务（增删改查、批量操作）都套用该骨架。

Step 1：发现可用工具

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Ticktick task"}]
session: {id: "existing_session_id"}

把 use_case 换成你的具体任务描述；如果处于同一工作流内，传入已存在的 session_id 而非重新生成。

Step 2：检查连接

RUBE_MANAGE_CONNECTIONS
toolkits: ["ticktick"]
session_id: "your_session_id"

在真正执行前再次确认 TickTick toolkit 的连接状态为 ACTIVE，避免因连接失效导致执行失败。

Step 3：执行工具

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: {/* schema-compliant args from search results */}
}]
memory: {}
session_id: "your_session_id"

这是实际的执行入口，几个字段各有讲究：

字段	说明
tools	数组，可一次传入多个工具实现链式/批量执行；tool_slug 必须来自 Step 1 的搜索结果，arguments 必须严格符合搜索返回的 schema
memory	必须始终携带，即使为空也要传 {}，用于在多工具调用间传递上下文状态
session_id	复用 Step 1/2 的会话 ID，保证同一工作流的状态连续性

常见陷阱与规避

Skill 明确列出六条实践纪律，它们是这套自动化方案稳定运行的关键：

1. 务必先搜索：工具 schema 会变。未经 RUBE_SEARCH_TOOLS 就硬编码工具 slug 或参数，是失败的头号来源；
2. 检查连接：执行工具前，确认 RUBE_MANAGE_CONNECTIONS 显示 ACTIVE 状态；
3. 遵循 schema：arguments 必须使用搜索结果的精确字段名与类型，多一个、少一个、错一个字段名都会导致调用失败；
4. memory 参数：RUBE_MULTI_EXECUTE_TOOL 调用中始终携带 memory，即使为空对象 {}；
5. 会话复用：同一工作流内复用 session ID，新工作流再生成新 ID——这是保证上下文连续与隔离的正确姿势；
6. 分页处理：检查响应中的分页 token，持续拉取直到取完所有数据，避免大列表任务只处理了第一页。

快速参考表

以下对照表可当作日常操作的速查手册：

操作	方式
查找工具	用 TickTick 专属 use case 调用 RUBE_SEARCH_TOOLS
建立连接	以 toolkit ticktick 调用 RUBE_MANAGE_CONNECTIONS
执行操作	用发现的工具 slug 调用 RUBE_MULTI_EXECUTE_TOOL
批量操作	RUBE_REMOTE_WORKBENCH 配合 run_composio_tool()
完整 schema	对带 schemaRef 的工具调用 RUBE_GET_TOOL_SCHEMAS

其中 RUBE_REMOTE_WORKBENCH 适用于需要代码化批量编排的场景——通过 run_composio_tool() 在远程执行环境中运行 Composio 工具；而 RUBE_GET_TOOL_SCHEMAS 用于获取某个 schemaRef 工具的完整 schema 定义，适合在需要精细参数控制时做补充查询。这两个工具在仓库 composio-skills/ 下 78 个自动化 Skill（如 composio-automation、composio-search-automation）中均有相同引用，属于 Rube MCP 的通用能力集。

从 TickTick 到 78 个应用的通用模式

需要特别指出的是，ticktick-automation 并不特殊——仓库 composio-skills/ 目录下全部 78 个应用自动化 Skill 共享完全相同的骨架：同样的 Rube MCP 前置条件、同样的三步工作流（搜索 → 检查连接 → 执行）、同样的六条陷阱纪律。差异仅在 use_case 描述、toolkit 名称（如 ticktick）与工具 slug 上。

因此，本文掌握的技能具备直接的可迁移性：一旦你熟练了 TickTick 的自动化流程，便可将同一套方法论平移到 Jira、Notion、Gmail 等其他 77 个应用（完整清单见 README.md 的 "App Automation via Composio" 章节）。这套"Skill 只编排行为、MCP 提供访问、schema 动态发现"的组合模式，正是本仓库希望示范的生产级 Agent 集成范式。