技能介绍

它解决的问题

在 Contentful 里，内容查询与自动化往往分散在 GraphQL 端点、认证连接和工具 schema 之间。直接写脚本很容易遇到字段变化、连接未激活、分页未拉完、session 复用混乱等问题。这个技能面向需要通过 Rube MCP 操作 Contentful GraphQL 的工程师，把“先发现可用工具、再确认连接、最后执行”的流程固定下来。

核心能力与关键步骤

工具发现优先：任何工作流开始前先调用 RUBE_SEARCH_TOOLS，获取当前可用的 tool slug、输入 schema、推荐执行计划和已知坑点。不要硬编码 slug 或参数。
确认连接状态：使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit contentful_graphql。若未处于 ACTIVE，先按返回的 auth link 完成授权，再继续。
按 schema 执行：拿到搜索结果后，严格使用返回的字段名与类型调用 RUBE_MULTI_EXECUTE_TOOL；批量操作可用 RUBE_REMOTE_WORKBENCH 的 run_composio_tool()；需要完整 schema 时用 RUBE_GET_TOOL_SCHEMAS。
保持执行连续性：同一工作流内复用 session ID，新工作流生成新 ID。即使没有附加记忆，也要给 memory 传空对象 {}。
处理分页：响应中出现 pagination token 时继续拉取，直到内容完整。

适用边界与注意点

它适合已经接入 Rube MCP、且需要通过 Composio 的 Contentful GraphQL toolkit 操作 Contentful 的场景。前提是 RUBE_SEARCH_TOOLS 可用，并且 Contentful GraphQL 连接为 ACTIVE。不要跳过搜索、不要在连接未激活时执行、不要凭旧 schema 写死参数。工具 schema 可能变化，执行前应以最新搜索结果为准。