Everhour 自动化实战指南：基于 Rube MCP（Composio）的 Claude Skill 工作流-平芜编程栈

AI 技能
AI 插件
人工智能
工作流自动化

【免费下载链接】awesome-claude-skills

A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows

项目地址：https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills

本篇技术指南围绕 composio-skills/everhour-automation/SKILL.md 展开，系统讲解如何通过 Rube MCP（Composio）为 Claude 注入 Everhour 自动化能力：从 MCP 连接、连接授权、工具发现到三步式执行工作流。读完本文，你将掌握RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三大核心工具的调用方式、会话与分页管理要领，以及一套可直接复用的时间跟踪自动化技能骨架。

技能定位：一份指导 Agent 行为的 SKILL.md

在正式动手之前，先理解这份文档在仓库中的角色。它是一个标准的 Claude Skill 定义文件，包含 YAML frontmatter 与 Markdown 正文两部分：

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

name：技能标识，即everhour-automation，对应仓库中的目录名；
description：Agent 在会话启动时最先看到的一行摘要，它决定了"何时激活该技能"，其中特别强调"Always search tools first for current schemas"（始终先搜索工具以获取当前 schema）——这是整份文档最核心的行为约束；
requires.mcp: [rube]：声明本技能依赖 Rube MCP 服务器，属于显式的运行前提。

这份技能归属于仓库 README.md 中 "App Automation via Composio" 分类下的预构建工作流技能族。该分类的说明指出：仓库为 78 个 SaaS 应用提供了基于 Rube MCP（Composio）的预构建技能，每个技能都包含工具序列、参数指引、已知陷阱与快速参考表，且全部使用从 Composio API 发现的真实工具 slug。everhour-automation正是其中之一，其正文即是一份面向 Agent 的可执行操作手册。

前置条件：让 Rube MCP 与 Everhour 连接就绪

执行任何自动化之前，必须满足文档列出的三项前提：

Rube MCP 已连接：客户端环境中应存在RUBE_SEARCH_TOOLS工具，这是技能可用的信号；
Everhour 连接已激活：通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为everhour的连接，且状态为 ACTIVE；
先搜索工具：每次执行前调用RUBE_SEARCH_TOOLS获取当前工具 schema，避免因 schema 变更而失败。

这三条是技能可靠运行的地基，后两者同时也是"已知陷阱"章节的重复强调项，说明它们在真实场景中是最常见的失败来源。

连接设置：三步建立 Rube MCP 与 Everhour

Rube MCP 的接入方式非常轻量——无需 API Key，只需在客户端配置中添加一个 MCP 服务器端点：

在客户端配置中，将https://rube.app/mcp添加为 MCP 服务器。无需 API Key，添加端点即可生效。

随后按照以下四步完成 Everhour 的连接与校验：

验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS有响应；
建立连接：调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为everhour；
完成授权：若连接状态不是 ACTIVE，则按照返回的授权链接完成 Everhour 账户的设置；
确认状态：在运行任何工作流之前，确认连接状态显示为 ACTIVE。

值得注意的是"无需 API Key"这一设计：Rube MCP 将认证与工具调用托管在远端，客户端只负责通过 MCP 协议发起请求，这与 connect/SKILL.md 中描述的 Composio 认证流程（首次使用某应用时通过授权链接完成 OAuth，之后连接持久化）一脉相承。授权后，Agent 便可代表用户在 Everhour 中执行操作。

工具发现：永远先调用 RUBE_SEARCH_TOOLS

技能文档将"工具发现"视为执行工作流的固定前置动作，并给出了标准的探索请求：

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

该调用的返回内容包含四类关键信息：

可用的工具 slug（tool slugs）；
各工具的输入 schema；
推荐的执行计划（execution plans）；
已知的陷阱（known pitfalls）。

session: {generate_id: true}用于让 MCP 为本次探索自动生成新的会话 ID；而known_fields留空则意味着让搜索以 use_case 为引导、尽可能完整地返回候选工具。这种"先探索、后执行"的模式贯穿整个技能族——仓库中 composio-automation/SKILL.md 等同类技能均采用完全一致的工具发现范式。

之所以必须"先搜索"，是因为工具 schema 会随 Composio 与 Everhour 集成版本演进而变化。硬编码工具 slug 或参数名，在 schema 变更后必然失败；而每次执行前动态搜索，则保证了 Agent 拿到的永远是当前有效的契约。

核心工作流模式：发现 → 检查 → 执行

技能正文给出了可复用的三步工作流，是整份文档的实操骨架。

Step 1：发现可用工具

针对具体任务发起搜索，复用既有会话：

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

将use_case替换为具体的 Everhour 任务描述（例如"为项目创建工时记录""列出某项目的任务清单"），返回结果中的工具 slug 将直接用于第三步执行。

Step 2：检查连接状态

执行前确认连接仍然有效：

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

这一步是防御性的：OAuth 令牌可能过期或连接被撤销，若直接执行工具，可能得到授权错误。先检查、再执行，可将失败前置到更易诊断的阶段。

Step 3：执行工具

用发现的 slug 与 schema 合规参数发起执行：

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

注意三个细节：

arguments中的字段名与类型必须严格取自 Step 1 的搜索结果；
memory参数必须始终携带，即使为空也要传{}；
session_id沿用 Step 2 中的同一会话，保证上下文连贯。

执行细节：会话复用、分页与批量操作

围绕三步工作流，文档还给出了若干执行层面的规范：

会话复用：同一工作流内复用会话 ID，保证多步调用之间的上下文一致性；开启新工作流时再生成新的会话 ID（对应session: {generate_id: true}）。
分页处理：检查响应中是否带有分页令牌（pagination token），若有则持续翻页直至取完全部数据，避免结果被截断导致决策依据不全。
批量操作与完整 schema：当需要批量执行时，可改用RUBE_REMOTE_WORKBENCH配合run_composio_tool()运行；当搜索结果中某个工具带有schemaRef引用时，则调用RUBE_GET_TOOL_SCHEMAS获取该工具的完整 schema。这两者作为进阶路径记录在快速参考表中。

已知陷阱：六条高频失败教训

技能文档将最易踩坑的行为固化为清单，值得在集成时逐条对照：

必须先搜索：工具 schema 会变化，未经RUBE_SEARCH_TOOLS就直接硬编码工具 slug 或参数，几乎必然失败；
必须检查连接：执行前确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE，防止对失效连接发起调用；
Schema 合规：字段名与类型必须与搜索结果完全一致，不要凭记忆猜测参数；
Memory 参数必带：RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory，即使为空对象{}；
会话复用：同一工作流内复用会话 ID，新工作流才生成新 ID；
分页兜底：检查响应中的分页令牌并持续取完，防止数据缺失。

这些陷阱本质上都在强调同一个原则：永远以运行时发现的信息为准，而非以静态记忆为准。这也是该技能族在 README.md 中被描述为"使用真实工具 slug、基于 Composio API 发现结果构建"的原因。

快速参考表：五种操作的入口工具

操作	入口
查找工具	`RUBE_SEARCH_TOOLS`，附带 Everhour 相关的 use_case
建立连接	`RUBE_MANAGE_CONNECTIONS`，toolkit 为`everhour`
执行工具	`RUBE_MULTI_EXECUTE_TOOL`，使用发现到的工具 slug
批量操作	`RUBE_REMOTE_WORKBENCH`，配合`run_composio_tool()`
获取完整 schema	`RUBE_GET_TOOL_SCHEMAS`，针对带`schemaRef`的工具

这张表是技能的最小速查面：从"找到工具"到"执行工具"，再到"批量执行"与"深挖 schema"，覆盖了自动化任务的完整生命周期。建议将这张表连同工具发现范式一起沉淀进你的 Agent 提示词或工作流模板中。

仓库中的同族技能：从骨架到参数的完整生态

everhour-automation并非孤例，它是仓库composio-skills/目录下 78 个应用自动化技能中的一员，这些技能共享同一套文档骨架（前置条件 → 连接设置 → 工具发现 → 三步工作流 → 陷阱清单 → 快速参考）。如果你想在 Everhour 的实战中参考更丰富的参数级细节，可以对照同族的 toggl-automation/SKILL.md——同为时间跟踪类应用，它在工具 slug、必填参数（如workspace_id、created_with、start等 ISO 8601 时间戳）以及分页参数（page/page_size）上有更细的展开，可作为理解RUBE_SEARCH_TOOLS搜索结果中"输入 schema"形态的参照；composio-automation/SKILL.md 则展示了同一工作流模式在平台级 toolkit 上的复用。

从更大的视角看，这份技能与 connect/SKILL.md 描述的能力一致：Claude 不再只是"生成一段关于发送邮件的文本"，而是真正在外部应用中执行操作。everhour-automation将这一能力收敛到 Everhour 这一个场景，并以"先搜索、后执行、带 memory、管会话、查分页"的工程化约束保证了执行的可靠性与可审计性。

结语：一份可直接落地的 Agent 操作手册

everhour-automation的本质，是一份将"Everhour 时间跟踪自动化"这一具体任务转化为 Agent 可执行指令的操作手册。它的价值不在于某个具体的业务功能，而在于其沉淀下来的通用方法论：动态发现工具契约、显式管理连接状态、三步执行流程、会话与分页规范、以及一份可防御的陷阱清单。这套方法论在仓库的 78 个技能中高度一致，意味着你学会这一份，即可触类旁通地使用整个 composio-skills 技能族，将 Claude 与任意一个 SaaS 应用连接起来执行真实操作。