企业官网建设流程全解析

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

导读

本指南围绕 awesome-claude-skills 仓库中的 gamma-automation 技能文档展开，讲解如何通过 Rube MCP 连接 Composio 的 Gamma 工具包，让 Claude 代理自动完成 Gamma 演示文稿的创建、编辑与管理等操作。读完本文，你将掌握"先搜索工具、再校验连接、最后执行调用"的标准自动化编排流程，并能正确规避工具架构变更、会话复用、分页处理等关键坑点，直接复用到仓库中其他 78 个 Composio 应用自动化技能上。

Gamma 自动化技能是什么

gamma-automation是仓库 composio-skills 目录下的一类技能：通过 Composio 的 Gamma 工具包，以 Rube MCP 为桥梁，把 Gamma（AI 演示文稿生成平台）的操作封装成可被 Claude 代理直接调用的工具。

该技能的元信息定义在 SKILL.md 的 frontmatter 中：

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

其中requires.mcp: [rube]声明了技能运行的前提：客户端必须已经接入 Rube MCP 服务器，Claude 才能获得RUBE_SEARCH_TOOLS等一批工具。这与仓库 README 的说明 一致——仓库为 78 个 SaaS 应用预置了基于 Rube MCP（Composio）的工作流技能，每个技能都包含真实工具序列、参数指引、已知坑点和速查表。

从仓库结构看，这类技能遵循 Claude Skills 开放标准的"渐进加载"设计（README.md#L98-L102）：会话启动时代理只看到技能的 name 和 description（约 100 token），只有在任务与该技能相关时，完整指令体才会加载。因此description中特意强调"Always search tools first for current schemas"，用于在技能尚未完整加载时就约束代理的行为习惯。

前置条件

根据 SKILL.md 的 Prerequisites 小节，使用该技能前必须满足三个条件：

• Rube MCP 已连接：客户端中可用RUBE_SEARCH_TOOLS工具；
• Gamma 连接处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为gamma的连接；
• 先调用RUBE_SEARCH_TOOLS：任何工作流执行前，都必须先获取当前的工具 schema，避免使用过时的工具名或参数。

环境配置（Setup）

配置的核心只有一步：把https://rube.app/mcp添加为 MCP 服务器端点，无需任何 API Key，加上端点即可工作（SKILL.md#L22）。

随后按以下 4 步确认环境就绪（SKILL.md#L24-L27）：

1. 确认 Rube MCP 可用：调用RUBE_SEARCH_TOOLS，观察其是否有响应；
2. 调用RUBE_MANAGE_CONNECTIONS，传入 toolkitgamma；
3. 若连接状态不是 ACTIVE，跟随返回的授权链接完成 OAuth 设置；
4. 在运行任何工作流之前，确认连接状态显示为ACTIVE。

值得注意的是，这一步与仓库中其他自动化技能（如 composio-automation、anthropic_administrator-automation）完全一致——Rube MCP 作为统一连接层，代理只需声明 toolkit 名称，Composio 侧会返回对应的授权链接与连接状态。

工具发现（Tool Discovery）

技能文档反复强调一个原则：执行工作流之前，永远先发现可用工具（SKILL.md#L29-L39）。

首次发现工具的标准调用形式：

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

其中generate_id: true表示本次会话是全新工作流，需要生成新的 session ID。该调用会返回：

• 可用的工具 slug（tool slugs）；
• 每个工具的输入 schema；
• 推荐的执行计划（execution plans）；
• 已知坑点与边界情况（known pitfalls）。

从实现原理看，这一步是对抗"工具 schema 漂移"的关键：Composio 侧工具会随 API 升级而变化，硬编码工具名与参数在 schema 变更后必然失败，而RUBE_SEARCH_TOOLS是获取"当前真实 schema"的唯一权威来源。这也是技能 description 里"Always search tools first"的设计动机。

核心工作流模式（Core Workflow Pattern）

标准工作流固定为三步（SKILL.md#L41-L69），每一阶段都有明确的工具与参数约定。

Step 1：发现可用工具

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

与首次发现不同，此处使用session: {id: "existing_session_id"}复用已有会话，保证同一工作流内的状态连续性。

Step 2：检查连接

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

在真正执行任何工具之前，再次确认 Gamma 连接仍为 ACTIVE。OAuth token 过期会导致调用失败，这一步能提前暴露问题。

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 字段名与类型；
• memory参数必须始终携带，即使没有状态要传也要写{}——它在RUBE_MULTI_EXECUTE_TOOL调用中是必填项。

这种"搜索→校验→执行"的三段式模式，与仓库内 composio-automation 技能 的 Core Workflow Pattern 逐字段一致，可以推断它是整个 composio-skills 系列技能共享的编排范式：先由RUBE_SEARCH_TOOLS承担"动态 schema 解析"职责，再由RUBE_MULTI_EXECUTE_TOOL统一承担"多工具批量执行"职责。

已知坑点（Known Pitfalls）

技能文档列出了 6 条必须遵守的实践约束（SKILL.md#L71-L78）：

其中"会话复用"与"分页"两条尤其影响多步骤任务的正确性：Gamma 的列表类操作（如查询已有演示文稿）常返回分页结果，只取第一页会导致后续步骤基于不完整数据执行；而跨步骤复用 session 则能保证上下文连续、避免重复授权开销。

快速参考（Quick Reference）

技能文档末尾以速查表形式总结了五种典型操作的正确入口（SKILL.md#L80-L88）：

最后两条补充说明：当RUBE_SEARCH_TOOLS返回的是schemaRef引用而非内联的input_schema时，需要用RUBE_GET_TOOL_SCHEMAS加载完整输入 schema；当面对大批量数据处理（如批量生成多份演示文稿）时，RUBE_REMOTE_WORKBENCH中的run_composio_tool()配合并行执行是推荐路径——这与仓库中 anthropic_administrator-automation 对批量操作的描述一致，可以推断为系列技能的通用批处理方案。

如何安装与使用该技能

本技能作为 Claude Skill 使用，安装方式与仓库 README 的 Getting Started 保持一致：

1. Claude Code 中安装：将技能目录复制到~/.config/claude-code/skills/下：

   mkdir -p ~/.config/claude-code/skills/ cp -r gamma-automation ~/.config/claude-code/skills/ head ~/.config/claude-code/skills/gamma-automation/SKILL.md # 校验元数据 claude # 启动后技能自动加载

2. Claude.ai 中安装：在聊天界面点击技能图标（🧩），从市场添加或上传自定义技能，Claude 会根据任务自动激活相关技能。
3. 通过 API 使用：调用 Claude Skills API 时在请求中传入skills参数加载技能。

需要强调的是，本技能目录内只有SKILL.md一份指令文件（无独立脚本与资源），其全部能力建立在 Rube MCP 提供的工具之上——这与仓库中 connect 等基于 Composio 的能力组织方式一脉相承：技能负责"教代理怎么做"，工具连接层负责"实际执行动作"（README.md#L102）。

延伸：把 Gamma 自动化并入更大的技能矩阵

gamma-automation并非孤立存在。仓库 README 的 App Automation via Composio 章节 按业务域收录了 78 个同类技能：CRM 与销售、项目管理、沟通协作、代码与 DevOps、存储与文件、电子表格与数据库、日历排程、社交媒体、营销邮件、客服工单、电商支付、设计协作、数据分析、HR 人事、自动化平台、Zoom 会议等。

如果你需要同时编排 Gamma 与多个应用，可以参考 composio-automation 的模式：在一次RUBE_MULTI_EXECUTE_TOOL调用中传入多个工具的 slug 与参数，即可把"生成 Gamma 演示文稿→写入 Google Drive→推送 Slack 通知"这类跨应用链路串成单一工作流。技能文档本身也提示：工具 schema 会随时间变化，跨应用编排时更要坚持"先搜索、再执行"，以当前搜索返回的 schema 为准。

小结

gamma-automation技能的价值不在于"多了一个工具"，而在于它固化了一套健壮的自动化编排纪律：发现优先、连接校验、schema 合规、会话与分页管理。这套纪律由技能文档、README 与仓库中数十个同类技能共同印证，构成了 Composio + Rube MCP 生态下可复制、可扩展的 Claude 自动化最佳实践。将其安装进你的 Claude Code 或 Claude.ai，即可让代理自主完成 Gamma 演示文稿的生成与管理，同时保持对底层 API 变更的鲁棒性。

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