awesome-codex-skills 中的 Craftmypdf 自动化技能基于 Rube MCP 让 Codex 动态操作 PDF 服务【免费下载链接】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/craftmypdf-automation/SKILL.md 为主体讲解如何把 Craftmypdf 的自动化能力接入 Codex CLI/API 生态读者将掌握 Rube MCP 端点的接入方式、Craftmypdf 连接的授权与状态确认流程、先搜索后执行的工具发现原则以及由RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL三个核心工具串联的完整调用模式并能直接按文档中的参数格式在真实会话中复现。技能定位Craftmypdf 操作走发现式工具链craftmypdf-automation是 awesome-codex-skills 仓库composio-skills/目录下数百个 Composio 集成技能之一其定位在 SKILL.md 的 frontmatter 中写得很明确--- name: craftmypdf-automation description: Automate Craftmypdf tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从这段元数据可以看出两个关键设计意图触发条件description说明了技能的用途通过 Rube MCP 自动化 Craftmypdf 任务和使用时机。按仓库 README.md 的说明Codex 会根据各技能的name与descriptionfrontmatter 决定何时触发该技能且正文只在触发后才被加载以保持上下文精简。运行依赖requires: mcp: [rube]声明该技能必须依赖 Rube MCP 服务。也就是说技能本身不包含任何 Craftmypdf 的 API 凭证或工具实现所有实际操作都经由 MCP 网关完成仓库 README 也将这类 MCP Gateway 概括为单一 MCP 端点 内置鉴权 团队访问控制的统一接入层。与仓库中其他 composio 技能如 pdf-api-io-automation/SKILL.md、replicate-automation/SKILL.md一样本技能遵循统一的Composio 工具包 Rube MCP模式差异仅在于所绑定的 toolkit 名称craftmypdf。理解这一点后文档中所有工作流都能在同一套 RUBE 工具调用范式下落地。前置条件在运行任何 Craftmypdf 工作流之前SKILL.md 要求同时满足三个前置条件Rube MCP 已连接客户端能够响应RUBE_SEARCH_TOOLS调用Craftmypdf 连接处于激活状态通过RUBE_MANAGE_CONNECTIONS以 toolkitcraftmypdf建立连接执行前始终先调用RUBE_SEARCH_TOOLS以获取当前最新的工具 schema。第三点贯穿全文是本技能最重要的约束后文常见陷阱一节会再次展开。Rube MCP 接入与 Craftmypdf 授权流程添加 MCP 端点文档给出的接入方式非常简单在客户端配置中把https://rube.app/mcp添加为 MCP server。文档特别强调无需 API key——添加端点后即可工作凭证问题留到连接授权环节解决。四步连接确认接入端点后按 SKILL.md 的 Setup 章节依次完成确认RUBE_SEARCH_TOOLS能正常响应验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为craftmypdf如果连接状态不是 ACTIVE按返回的 auth link 完成授权配置在运行任何工作流之前确认连接状态显示为ACTIVE。这一步的设计意图是把连接是否可用变成工作流中的显式检查项而不是假设它一直有效。授权链接机制意味着 Craftmypdf 账号的认证由 Composio 侧托管技能使用者无需在本地保存 Craftmypdf 的 API 密钥。工具发现RUBE_SEARCH_TOOLS 先于一切执行本技能没有像某些技能那样硬编码一份工具清单对比 replicate-automation/SKILL.md 中列出的 8 个REPLICATE_*固定工具而是要求每次执行工作流前先做工具发现。首次调用的标准格式为RUBE_SEARCH_TOOLS queries: [{use_case: Craftmypdf operations, known_fields: }] session: {generate_id: true}参数说明queries查询数组。use_case描述要自动化的业务场景此处为泛化的 Craftmypdf operations后续具体工作流可替换为更精确的任务描述known_fields留空字符串表示不带额外字段提示session: {generate_id: true}让服务端生成本次会话的 ID后续步骤将复用该 ID 保持上下文连贯。该调用返回四类信息可用工具的 slug工具标识、输入 schema、推荐的执行计划、已知的坑。也就是说具体有哪些 Craftmypdf 工具、每个工具接受哪些参数全部以当次搜索结果为准——这正是Never hardcode tool slugs这条铁律的由来。核心工作流三步调用模式SKILL.md 的 Core Workflow Pattern 把一次完整的自动化执行拆成三步参数格式可直接复制使用。第 1 步发现可用工具用与首次发现相同的RUBE_SEARCH_TOOLS但把use_case换成具体任务描述并把会话参数从生成切换为复用RUBE_SEARCH_TOOLS queries: [{use_case: your specific Craftmypdf task}] session: {id: existing_session_id}注意这里session用的是{id: existing_session_id}即复用第 1 步或首次发现时生成的会话 ID。第 2 步检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [craftmypdf] session_id: your_session_id在真正执行工具前再次确认craftmypdftoolkit 的连接为 ACTIVE避免在连接失效时浪费执行轮次。第 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必须原样使用RUBE_SEARCH_TOOLS返回的 slug不能凭记忆或经验拼接arguments的字段名与类型必须与搜索结果中的输入 schema 完全一致schema 合规性memory参数必须出现即使没有记忆内容也要传空对象{}整个执行链复用同一个session_id。从这套调用模式可以看出技能的设计哲学把工具清单 schema视为服务端动态事实客户端技能只固化流程骨架发现 → 验连接 → 执行从而在 Craftmypdf 工具集更新时不需要修改技能文档本身。常见陷阱与规避方式SKILL.md 的 Known Pitfalls 一节列出了六条逐条对应工作流中的具体环节陷阱规避方式对应环节硬编码工具 slug / 参数工具 schema 会变化任何执行前必须先RUBE_SEARCH_TOOLS第 1 步未验证连接就执行先确认RUBE_MANAGE_CONNECTIONS状态为 ACTIVE第 2 步参数不合规严格使用搜索结果中的字段名与类型schema 合规第 3 步漏传memory参数RUBE_MULTI_EXECUTE_TOOL调用始终携带memory空则为{}第 3 步会话管理混乱同一工作流内复用 session ID新工作流才生成新 ID全链路漏翻页检查响应中的分页 token持续拉取直至完整结果处理其中会话复用与分页两条是通用性最强的前者保证一次多步操作发现→验连接→执行处于同一上下文会话中后者要求对返回列表型结果例如 Craftmypdf 侧的资源、任务列表保持完整拉取避免只处理第一页数据。快速参考表SKILL.md 末尾的 Quick Reference 汇总了各操作对应的工具适合作为工作流速查操作对应工具/方式查找工具RUBE_SEARCH_TOOLSuse_case 指向具体的 Craftmypdf 场景建立连接RUBE_MANAGE_CONNECTIONStoolkit 为craftmypdf执行工具RUBE_MULTI_EXECUTE_TOOL使用发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对带有schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS表中两个进阶入口值得注意当需要批量执行多个 Craftmypdf 操作时可以转向RUBE_REMOTE_WORKBENCH以run_composio_tool()方式驱动当搜索结果中的工具只给出schemaRef而非完整 schema 时需要用RUBE_GET_TOOL_SCHEMAS拉取完整定义后再构造参数——这是保证第 3 步schema 合规的补充手段。安装与验证技能按仓库 README.md 的 Quickstart把本技能装入 Codex 有两种方式安装器方式推荐git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills # 安装到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/craftmypdf-automation安装器会把技能放到$CODEX_HOME/skills/skill-name也可参考 skill-installer/SKILL.md 中列出的选项--ref、--dest、--method auto|download|git多次--path可一次安装多个技能。手动安装将composio-skills/craftmypdf-automation目录复制到$CODEX_HOME/skills/默认~/.codex/skills/然后重启 Codex 使其加载新的元数据。安装完成后的验证方式与仓库 README 一致ls ~/.codex/skills查看已装技能head ~/.codex/skills/craftmypdf-automation/SKILL.md检查 frontmatter 元数据。需要注意的运行前提该技能依赖 Rube MCP 端点可达且 Craftmypdf 连接需按四步连接确认完成授权技能本身在仓库中仅包含 SKILL.md 这一个文件不含脚本或本地实现所有实际能力均由 MCP 网关侧提供。小结craftmypdf-automation展示了一种面向 SaaS 工具的 Codex 技能写法技能文件只沉淀触发条件frontmatter、前置检查Rube MCP 连接 ACTIVE 授权和稳定的调用骨架搜索 → 验连接 → 多工具执行把易变的工具清单与参数 schema 完全交给RUBE_SEARCH_TOOLS在运行时提供。遵循文档中的会话复用、memory 必传、分页检查等约束即可在 Codex CLI/API 会话中可靠地自动化 Craftmypdf 操作同一套模式也可平移到仓库composio-skills/下其他 toolkit 的同类技能。【免费下载链接】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），仅供参考