用 Rube MCP 管理 Contentful 空间元数据awesome-codex-skills 中 Contentful Automation 技能实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本篇基于 composio-skills/contentful-automation/SKILL.md 展开讲解如何通过 Composio 的 Rube MCP 网关在终端里管理 Contentful headless CMS 的空间Space元数据。读完后你将掌握三个核心工具列举空间、获取空间详情、重命名空间的参数细节与调用顺序理解乐观锁optimistic locking在并发更新中的作用并知道如何把该技能安装进$CODEX_HOME/skills目录完成验证。技能定位与触发机制Contentful Automation 技能的定位是让 Agent 不离开终端即可完成对 Contentful 空间的列举、查询与配置更新。技能的元数据定义在SKILL.md的 YAML frontmatter 中--- name: Contentful Automation description: Automate headless CMS operations in Contentful -- list spaces, retrieve space metadata, and update space configurations through the Composio Contentful integration. requires: mcp: - rube ---name/description决定了 Agent 何时触发该技能。按照本仓库 README 中的说明Codex 读取description来判断用户请求是否匹配命中后才加载技能正文从而保持上下文精简requires.mcp声明了该技能依赖名为rube的 MCP 服务器——即 Composio 的 Rube MCP 网关所有CONTENTFUL_*工具都通过它执行技能的覆盖范围刻意收敛在space 级元数据主要是命名不触及 entries、content types、assets 等内容层对象这一点在后文的已知陷阱中还会强调。环境准备添加 Rube MCP 并连接 Contentful 账号原文档给出了两步 Setup可复制执行在客户端配置中添加 Composio MCP 服务器端点为https://rube.app/mcp即把该端点写入你所用 AgentCodex / Claude Code的 MCP 服务器配置。按提示连接 Contentful 账号Agent 会提供一个认证链接完成后即建立连接。务必确认你的 access token 具备space management权限范围——只读 token 能成功GET但会在UPDATE时失败对应后文的权限陷阱。一个与本文档同系列的技能 composio-skills/contentful-graphql-automation/SKILL.md 展示了更完整的连接管理流程通过RUBE_MANAGE_CONNECTIONS检查 toolkit 连接状态是否为 ACTIVE未激活时跟随返回的认证链接完成授权。虽然 Contentful Automation 技能本身没有展开这些步骤但从源码结构看两者共享同一套 Rube MCP 连接机制遇到连接未激活类报错时可参照该技能的排障顺序。核心工具一CONTENTFUL_LIST_SPACES——列举空间这是通常的第一操作因为其余操作几乎都依赖space_id。该工具列举当前认证账号可访问的所有 Contentful 空间。关键参数参数说明limit单次返回的空间数量上限取值1–1000默认100skip跳过的空间数量用于分页order排序字段如sys.createdAt升序-sys.createdAt表示降序原文档给出的示例提示词List all my Contentful spaces分页注意当组织内空间数量较多时需要递增skip反复调用直到返回结果为空才能确保不遗漏空间原文档Known Pitfalls中专门列出这条。核心工具二CONTENTFUL_GET_SPACE——获取空间详情检索指定空间的完整元数据其中最关键的是返回体中的sys.version字段——它是后续更新操作的乐观锁版本号。关键参数参数说明space_id必填要获取的空间 ID字母数字格式1–64 字符示例提示词Get details for Contentful space abc123def从该技能的设计看GET_SPACE不只是查看详情更是UPDATE_SPACE的前置依赖更新前必须先拿到最新sys.version。核心工具三CONTENTFUL_UPDATE_SPACE——重命名空间乐观锁更新指定空间的名称。为了防止并发修改冲突Contentful 采用乐观锁机制你必须提交读取时看到的当前版本号服务端会校验版本一致后才允许写入。关键参数参数说明space_id必填要更新的空间 IDname必填空间的新名称1–255 字符version必填来自sys.version的当前版本号必须 0示例提示词Rename Contentful space abc123def to Production Content Hub标准调用顺序是GET_SPACE取sys.version→UPDATE_SPACE带上该版本。原文档明确提醒如果在你读取和写入之间有其他成员修改了空间更新会以 version conflict 失败因此要在更新前紧贴着获取一次空间详情压缩竞态窗口。组合工作流空间清单审计Audit Space Inventory原文档的第四个工作流展示了两个工具的组合用法用于审计组织内所有 Contentful 空间调用CONTENTFUL_LIST_SPACES拿到所有空间的 ID 与名称空间多时按limit/skip分页遍历对每个空间调用CONTENTFUL_GET_SPACE补齐版本号、创建时间等元数据。示例提示词Audit all Contentful spaces -- list them with their creation dates and current versions这类先列举、再逐条取详情的模式在多资源 SaaS 平台需要逐对象拉取版本或时间戳的场景中是通用范式本技能把它固化成了可直接用自然语言触发的流程。已知陷阱与规避方式原文档的 Known Pitfalls 一节是实战价值最高的部分完整继承如下更新时的版本冲突CONTENTFUL_UPDATE_SPACE要求携带来自CONTENTFUL_GET_SPACE的最新sys.version。若读与写之间空间被他人修改更新会因 version conflict 失败。规避方式更新前立即重新获取空间详情。多空间场景的分页CONTENTFUL_LIST_SPACES依赖limit1–1000默认 100与skip。空间很多时要循环递增skip直到返回空结果避免漏掉空间。能力边界这组工具只管理space 级元数据名称无法创建或修改空间内的 entries、content types、assets。不要把该技能当成内容编辑入口。认证/权限错配即使只读操作GET_SPACE成功UPDATE_SPACE仍可能因 token 缺少 space management 范围而失败。排查时优先验证 token 的写权限。空间 ID 格式space_id必须匹配正则^[a-zA-Z0-9-_.]{1,64}$包含其他字符会被直接拒绝。注意该模式允许字母、数字、连字符、下划线与点号。快速参考表工具 Slug用途CONTENTFUL_LIST_SPACES列举账号可访问的所有空间CONTENTFUL_GET_SPACE获取单个空间的详细元数据含sys.versionCONTENTFUL_UPDATE_SPACE更新空间名称必须携带version安装与验证该技能该技能目录位于 composio-skills/contentful-automation/仅含一个SKILL.md文件属于纯指令型技能无附加脚本。按本仓库 README 给出的两种方式安装方式一使用仓库内置安装脚本python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/contentful-automation脚本会将技能放入$CODEX_HOME/skills/skill-name默认~/.codex/skills。skill-installer/SKILL.md 说明其行为细节默认直接下载公共仓库文件、失败时回退到 git sparse checkout、目标目录已存在时中止并支持--ref、--dest、--method auto|download|git等选项。方式二手动安装把composio-skills/contentful-automation整个目录拷贝到~/.codex/skills/下。安装后重启 Codex使其重新加载技能元数据然后可用以下命令验证ls ~/.codex/skills # 确认目录存在 head ~/.codex/skills/contentful-automation/SKILL.md # 检查 name/description frontmatter另外由于 frontmatter 声明了requires.mcp: rube还需确保第 2 节中的 Rube MCP 端点已正确配置否则技能被触发后找不到CONTENTFUL_*工具。进阶与 Contentful GraphQL 技能的分工本仓库composio-skills/目录下还存在 contentful-graphql-automation 技能同样走 Rube MCP但面向 Contentful GraphQL 这一不同 toolkit。两者在工具发现策略上有明显差异从源码结构看可以这样理解分工Contentful Automation本文主体工具 slug 已固化为CONTENTFUL_LIST_SPACES/CONTENTFUL_GET_SPACE/CONTENTFUL_UPDATE_SPACE参数契约直接写在技能里适合确定性、低摩擦的 space 管理场景Contentful GraphQL 技能要求先调用RUBE_SEARCH_TOOLS获取当前工具 schema再经RUBE_MANAGE_CONNECTIONS确认连接 ACTIVE最后用RUBE_MULTI_EXECUTE_TOOL执行并强调schema 会变不要硬编码 slug。适合操作面更宽、schema 演进更快的 GraphQL 场景。因此如果你的任务只是看有哪些空间、查空间元数据、改空间名用本文的 Contentful Automation 技能即可如果涉及 GraphQL 侧的查询/内容操作则应切换到兄弟技能并遵循其先搜索、再执行的工作流。小结Contentful Automation 技能用三个工具 一条组合工作流覆盖了 headless CMS 空间治理中最高频的终端操作列举含分页参数limit/skip/order、详情拿sys.version、重命名乐观锁约束。它的价值不在于覆盖面广而在于把版本冲突、分页遍历、权限范围、ID 格式这些真实运维中会踩的坑连同参数取值范围limit1–1000 默认 100、name1–255 字符、space_id正则约束一起前置写进了技能指令使 Agent 在触发时即具备规避这些陷阱的完整上下文。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考