awesome-claude-skills 中 Klipfolio 自动化 Skill 实战:基于 Rube MCP 的 Klipfolio 工作流编排指南

发布时间:2026/10/3 16:43:07
awesome-claude-skills 中 Klipfolio 自动化 Skill 实战:基于 Rube MCP 的 Klipfolio 工作流编排指南 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/klipfolio-automation/SKILL.md 这份 Skill 文档展开讲解如何通过 Rube MCPComposio连接 Klipfolio 工具箱并用「先发现工具、再确认连接、最后执行动作」的三段式模式编排 Klipfolio 自动化任务。读完本文你将掌握RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL的完整调用范式、Session 复用规则与六大常见陷阱能够直接在 Claude 类 Agent 中落地 Klipfolio 工作流自动化。Skill 定位与工作原理klipfolio-automation是 awesome-claude-skills 仓库中 composio-skills/ 集合下的一个预置工作流 Skill。根据仓库 README.md 的说明composio-skills 目录包含 78 个 SaaS 应用的预置工作流 Skill每个 Skill 都提供工具调用序列tool sequences、参数指引parameter guidance、已知陷阱known pitfalls与快速参考表quick reference tables且全部使用从 Composio API 实际发现的真实工具 slug。该 Skill 的 YAML 元数据非常简洁却定义了关键约束--- name: klipfolio-automation description: Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中description字段明确写入了核心纪律——「Always search tools first for current schemas」执行前务必先搜索工具以获取当前 schema而requires.mcp: [rube]声明了本 Skill 的运行依赖必须挂载 Rube 这个 MCP 服务器。Rube MCP 是什么Rube MCP 是本文工作流的技术底座。它由 Composio 提供作用是把 Composio 平台上针对各类 SaaS 应用的工具箱toolkit以 MCP 协议暴露给 Claude 等 Agent。其核心优势是无需任何 API Key——只需把 MCP 端点地址添加到客户端配置中即可直接使用本 Skill 文档在 Setup 一节明确说明了这一点。从仓库中的 connect/SKILL.md 可以对照理解其底层机制Composio 通过 Tool Router工具路由器在 1000 集成中自动挑选正确工具OAuth 认证自动处理Agent 只需发出请求即可完成真实动作。Klipfolio 自动化 Skill 正是这一机制在 Klipfolio 业务场景上的封装把「连接 → 发现 → 执行」的通用流程沉淀为可复用的工作流指引。前置条件在使用本 Skill 之前需要确认以下三项条件全部满足Rube MCP 已连接环境中必须可用RUBE_SEARCH_TOOLS工具这是所有后续操作的前提Klipfolio 连接已激活已通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为klipfolio的连接且状态为 ACTIVE先搜索后执行无论任务大小调用任何工具之前都必须先调用RUBE_SEARCH_TOOLS获取当前 schema避免因工具签名变更导致调用失败。从仓库源码结构看这组前置条件在 composio-skills 集合的全部 800 个 Skill 中高度一致例如 active-campaign-automation/SKILL.md、slack-automation 等同目录 Skill 均遵循同一模式说明这是一套被反复验证的通用接入规范。环境接入Setup接入流程分为两层先接入 Rube MCP 本身再建立 Klipfolio 的连接。获取 Rube MCP在客户端配置中把 Rube 的 MCP 端点https://rube.app/mcp添加为 MCP 服务器即可。不需要 API Key添加端点后即可正常工作。建立 Klipfolio 连接按以下四步完成通过确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 已可用调用RUBE_MANAGE_CONNECTIONStoolkit 指定为klipfolio若连接状态不是 ACTIVE则按返回的认证链接完成授权设置在运行任何工作流之前再次确认连接状态已变为 ACTIVE。这一步的关键判断标准是连接状态必须为 ACTIVE。只有连接激活后续的工具执行才有合法的认证上下文状态非 ACTIVE 时强行执行通常会导致认证类错误。工具发现RUBE_SEARCH_TOOLSSkill 文档反复强调任何工作流开始前必须先发现可用工具。这是因为工具 schema 是动态变化的——工具 slug、入参字段名与类型都可能在服务端更新硬编码任何 slug 或参数都是不安全的做法。发现工具的调用示例RUBE_SEARCH_TOOLS queries: [{use_case: Klipfolio operations, known_fields: }] session: {generate_id: true}其中use_case描述你的具体业务意图例如读取 Klipfolio 数据源、更新 KPI 看板等是搜索的核心查询条件known_fields用于传入你已知的字段线索首次搜索可留空session.generate_id: true表示本次搜索会生成一个新的会话 ID供后续调用沿用。该调用会返回可用的工具 slug 列表、输入 schema、推荐执行计划recommended execution plans以及已知陷阱known pitfalls。换言之一次搜索不仅告诉你「有哪些工具」还直接给出「该怎么组合使用、有哪些坑」——这正是本 Skill 以搜索结果为执行依据的设计初衷。核心工作流模式Skill 文档给出了一个固定的三步工作流模式任何 Klipfolio 自动化任务都可以套用。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Klipfolio task}] session: {id: existing_session_id}与首次发现不同进入既有工作流后应复用已生成的会话 IDsession.id保证上下文连续。use_case替换为你的具体任务描述例如「获取 Klipfolio 中某数据源的最近数据」。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [klipfolio] session_id: your_session_id执行任何工具前用同一会话 ID 确认 Klipfolio 连接仍处于 ACTIVE 状态。连接失效时如 OAuth token 过期、用户在应用内撤销授权此步会返回非 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执行阶段有三个要点tool_slug必须来自 Step 1 搜索结果不要凭记忆硬编码arguments必须严格遵循搜索结果返回的 schema——字段名、类型、必填项都要与 schema 一致schema compliancememory参数必须始终携带即使当前任务用不到也要显式传空对象{}session_id沿用本工作流的会话 ID。RUBE_MULTI_EXECUTE_TOOL的设计支持一次调用执行多个工具tools为数组适合把多个 Klipfolio 操作编排成一条流水线例如「读取数据 → 聚合 → 写入另一个看板」。已知陷阱与规避策略Skill 文档专门列出六大已知陷阱这是实战中最容易踩坑、也最值得反复强调的部分务必先搜索工具 schema 会变化不调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是最高频的失败原因执行前检查连接必须确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE 状态再做工具调用严格遵循 schema参数必须使用搜索结果中的精确字段名与类型任何近似写法都可能被拒绝始终携带 memory 参数RUBE_MULTI_EXECUTE_TOOL的每次调用都要包含memory即使为空也要传{}会话复用规则同一工作流内复用同一会话 ID新工作流才生成新会话注意分页检查响应中是否包含分页 tokenpagination token若有则持续拉取直到数据完整。这六条陷阱本质上指向同一个理念以运行时发现的真实 schema 为准而不是以文档或记忆为准。这与 Skill 元数据中「Always search tools first」的描述形成呼应。快速参考表Skill 文档结尾提供了五类操作的速查表可粘贴为工作流速查清单操作方式查找工具携带 Klipfolio 专属 use case 调用RUBE_SEARCH_TOOLS建立连接以 toolkitklipfolio调用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 工具而当搜索结果中某工具通过schemaRef引用 schema 而非内联给出时则需要RUBE_GET_TOOL_SCHEMAS主动拉取完整 schema 定义。在仓库中的定位与延伸阅读本 Skill 是 awesome-claude-skills「App Automation via Composio」能力矩阵的一员。仓库 README.md 将该集合定位为「Pre-built workflow skills for 78 SaaS apps via Rube MCP」覆盖 CRM、项目管理、通信、邮件、DevOps、存储、电子表格、日历、社交媒体、营销、客服、电商支付、设计协作、数据分析、HR 与会议等 16 类场景Klipfolio 自动化与之遵循完全相同的文档结构工具序列 参数指引 已知陷阱 快速参考表你可以把本文的三步模式平移到任意兄弟 Skill。如需了解更底层的连接机制可对照阅读 connect/SKILL.md它展示了 Composio Tool Router 如何自动选择工具、自动处理 OAuth以及如何通过session.mcp.url把 Composio 会话接入任意 MCP 客户端——这与本 Skill 中「连接 ACTIVE 后即可执行」的语义一脉相承。实践建议将本 Skill 与 Claude Code 或 Claude.ai 结合使用时先跑通「搜索 → 连接 → 执行」的最小闭环可用只读查询类任务验证连接再逐步叠加写入类操作每次任务开始前都重新执行RUBE_SEARCH_TOOLS把「schema 可能已变」作为默认假设即可最大程度规避文中列出的六大陷阱。赞分享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点击查看免费下载相关推荐Chatfai 自动化实战基于 Rube MCP 在 awesome-claude-skills 中编排 Claude Skill 工作流Chatfai 自动化实战基于 Rube MCP 在 awesome claude skills 中编排 Claude Skill 工作流 本文以仓库内 chAI 技能AI 插件人工智能工作流自动化基于 awesome-claude-skills 的 Affinity 自动化 Skill通过 Rube MCP 编排 Composio 工作流基于 awesome claude skills 的 Affinity 自动化 Skill通过 Rube MCP 编排 Composio 工作流 导读 本文围AI 技能AI 插件人工智能工作流自动化awesome-claude-skills 的 BugHerd 自动化基于 Rube MCP 与 Composio 工具编排的 Claude Skill 实战指南awesome claude skills 的 BugHerd 自动化基于 Rube MCP 与 Composio 工具编排的 Claude Skill 实战AI 技能AI 插件人工智能工作流自动化创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考