Everhour 自动化实战指南：基于 Rube MCP（Composio）的 Claude Skill 工作流

AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA 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 MCPComposio为 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对应仓库中的目录名descriptionAgent 在会话启动时最先看到的一行摘要它决定了何时激活该技能其中特别强调Always search tools first for current schemas始终先搜索工具以获取当前 schema——这是整份文档最核心的行为约束requires.mcp: [rube]声明本技能依赖 Rube MCP 服务器属于显式的运行前提。这份技能归属于仓库 README.md 中 App Automation via Composio 分类下的预构建工作流技能族。该分类的说明指出仓库为 78 个 SaaS 应用提供了基于 Rube MCPComposio的预构建技能每个技能都包含工具序列、参数指引、已知陷阱与快速参考表且全部使用从 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 与 EverhourRube 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}该调用的返回内容包含四类关键信息可用的工具 slugtool 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_CONNECTIONStoolkit 为everhour执行工具RUBE_MULTI_EXECUTE_TOOL使用发现到的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_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 应用连接起来执行真实操作。赞分享AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载相关推荐Echtpost 自动化实战基于 Rube MCPComposio的 Claude Skill 工作流指南Echtpost 自动化实战基于 Rube MCPComposio的 Claude Skill 工作流指南 导读 本指南以仓库中的 composio skAI 技能AI 插件人工智能工作流自动化Dovetail 自动化实战基于 Rube MCPComposio的 Claude Skill 工作流指南Dovetail 自动化实战基于 Rube MCPComposio的 Claude Skill 工作流指南 导读 本文围绕 awesome claudeAI 技能AI 插件人工智能工作流自动化GoSquared 自动化实战基于 Rube MCPComposio的 Claude Skill 工作流指南GoSquared 自动化实战基于 Rube MCPComposio的 Claude Skill 工作流指南 本指南围绕 awesome claude sAI 技能AI 插件人工智能工作流自动化上一篇RK3568 刷 Armbian 家庭服务器完整指南3 步把安卓盒子改成家用小服务器下一篇chaosArsenal-hardware源码解析深入理解故障注入引擎的实现机制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考