awesome-codex-skills 中的 DPD2 自动化技能基于 Rube MCPComposio的物流工具集成实战【免费下载链接】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本文以 awesome-codex-skills 仓库中的 dpd2-automation 技能文档 为主体完整讲解该 Codex Skill 的元数据、前置条件、Rube MCP 接入方式、三步核心工作流工具发现、连接检查、工具执行、已知陷阱与快速参考表。读完本文你将掌握如何在 Codex CLI 中通过 Rube MCP 连接 Composio 的 DPD2 工具包并以“先搜索、后执行”的规范模式驱动 DPD2 自动化操作。技能定位一个声明式 MCP 自动化技能该技能位于仓库的 composio-skills/ 技能族中。仓库内 composio-skills 目录下共包含 832 个按工具包命名的技能目录dpd2-automation 是其中之一对应 Composio 的 DPD2 工具包DPD2 是一款面向物流/运输场景的 SaaS 工具。技能的核心定义在 SKILL.md 的 YAML frontmatter 中--- name: dpd2-automation description: Automate Dpd2 tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各有明确职责这也符合仓库 README.md 中对 Codex 技能机制的说明——Codex 依据descriptionfrontmatter 判断何时触发技能并在触发后才加载正文从而保持上下文精简name: dpd2-automation技能唯一标识安装后作为$CODEX_HOME/skills/下的目录名description描述技能能力与触发时机并内嵌了最关键的行为约束——“Always search tools first for current schemas”始终先搜索工具以获取最新 schemarequires.mcp: [rube]声明该技能运行依赖名为rube的 MCP 服务器即 Rube MCPComposio 提供的 MCP 网关端点。从源码结构看该技能与同族的其他技能如 d2lbrightspace-automation采用完全一致的模板骨架仅工具包名称不同。这种统一结构意味着掌握了 dpd2 技能的用法即可迁移到仓库中其余 800 多个工具包技能上。前置条件Prerequisites文档明确要求满足以下三项前置条件后再运行任何工作流Rube MCP 已连接MCP 客户端中可用判据是RUBE_SEARCH_TOOLS工具可被调用并有响应存在活跃的 DPD2 连接通过RUBE_MANAGE_CONNECTIONS管理指定 toolkit 为dpd2始终以RUBE_SEARCH_TOOLS为第一步先拿到当前工具的最新 schema再执行后续动作。第 3 条是整个技能最重要的设计原则后文的陷阱清单中还有呼应工具 slug 和入参 schema 是动态的不允许硬编码。接入 Rube MCPSetup 流程文档给出的接入方式非常轻量在 MCP 客户端配置中将 Rube MCP 端点https://rube.app/mcp添加为一个 MCP 服务器即可文档明确说明无需 API Key——添加端点后直接可用。接入后的四步验证流程验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有响应发起连接管理调用RUBE_MANAGE_CONNECTIONStoolkit 指定为dpd2完成授权若连接状态不是 ACTIVE按接口返回的 auth link 完成授权设置确认状态在任何工作流执行前确认连接状态显示为 ACTIVE。这一步的价值在于把“认证”从本地配置转移到了远端工具链本地 Codex 不持有 DPD2 的任何凭据授权链接由 Rube MCP 侧生成凭据由 Composio 工具链托管。工具发现Tool Discovery执行任何工作流之前必须先发现可用工具。文档给出的标准调用是RUBE_SEARCH_TOOLS queries: [{use_case: Dpd2 operations, known_fields: }] session: {generate_id: true}其中两个参数值得注意queries是数组每项含use_case自然语言描述用例和可选的known_fields用自然语言描述具体任务如“查询 DPD2 运单状态”比泛化描述能拿到更贴合的工具列表session: {generate_id: true}表示由服务端生成本次会话 ID。该 session ID 是后续步骤复用的关键句柄见下文“会话复用”陷阱。调用返回内容包含四类信息可用工具的 slug、入参 schema、推荐执行计划recommended execution plans、已知陷阱known pitfalls。这决定了后续执行步骤中tool_slug与arguments的取值来源——一切以搜索结果的实时返回为准。核心工作流Core Workflow Pattern文档将完整工作流拆解为三步三步之间通过 session ID 串联。Step 1发现可用工具针对具体任务发起搜索并复用 Step 0工具发现生成的会话RUBE_SEARCH_TOOLS queries: [{use_case: your specific Dpd2 task}] session: {id: existing_session_id}与初始发现不同的是此处使用session: {id: existing_session_id}传入已有会话 ID而不是generate_id: true保证同一工作流内多轮工具调用共享同一上下文。Step 2检查连接状态在执行前确认 DPD2 连接处于 ACTIVERUBE_MANAGE_CONNECTIONS toolkits: [dpd2] session_id: your_session_idStep 3执行工具使用RUBE_MULTI_EXECUTE_TOOL批量执行已发现的工具。tool_slug取自 Step 1 搜索结果arguments必须严格符合搜索结果给出的 schemaRUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id注意tools同样是数组结构一次调用可携带多个工具执行项配合memory: {}参数即使为空也必须传入原因见陷阱清单。已知陷阱Known Pitfalls逐条解析文档列出了 6 条生产环境踩坑经验每一条都对应工作流中的具体约束Always search first始终先搜索工具 schema 会变化未经RUBE_SEARCH_TOOLS确认前严禁硬编码 tool slug 或参数。这是动态 MCP 工具链与静态 SDK 集成的本质区别Check connection检查连接执行工具前验证RUBE_MANAGE_CONNECTIONS返回 ACTIVE 状态避免在断连状态下批量报错Schema complianceschema 合规字段名与类型必须与搜索结果逐字一致不能凭记忆或类似工具包的经验拼参数Memory parametermemory 参数调用RUBE_MULTI_EXECUTE_TOOL时必须携带memory字段空对象{}也要显式传入——从调用契约看这是一个必填而非可选字段Session reuse会话复用同一工作流内复用 session ID新工作流才生成新会话。错误地频繁新建会话会丢失工作流内的上下文关联Pagination分页处理检查响应中的分页 token持续拉取直到数据完整避免只处理第一页结果。快速参考Quick Reference文档附带的操作速查表完整保留如下覆盖了从发现到执行、从批量到全量 schema 的常用路径操作方式查找工具RUBE_SEARCH_TOOLS使用 DPD2 相关的具体 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定dpd2执行工具RUBE_MULTI_EXECUTE_TOOL使用发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS速查表中还揭示了两个正文未展开的进阶能力RUBE_REMOTE_WORKBENCH支持通过run_composio_tool()做批量操作RUBE_GET_TOOL_SCHEMAS用于获取搜索结果中带schemaRef标记的工具的完整 schema——说明搜索返回的 schema 可能是引用式的需要二次拉取才能得到全量定义。在仓库中安装与验证该技能该技能遵循仓库标准的技能布局SKILL.md必备可选scripts/、references/、assets/子目录dpd2-automation 仅含一个 SKILL.md属于纯指令型技能。按仓库 README.md 的 Quickstart推荐用内置安装器安装git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills # 将 dpd2 技能安装到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/dpd2-automation也可以手动将composio-skills/dpd2-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/。两种方式的共同要求是安装或更新后重启 Codex以重新加载技能元数据。可用以下命令验证ls ~/.codex/skills # 确认技能目录存在 head ~/.codex/skills/dpd2-automation/SKILL.md # 确认 name/description frontmatter关于安装器行为skill-installer 技能文档 补充了几个实操细节若目标技能目录已存在会直接中止支持--ref默认main、--dest、--method auto|download|git选项下载失败且涉及权限错误时会回退到 git sparse checkout。小结dpd2-automation 技能的价值不在 DPD2 这一个工具包而在于它示范了一套适用于任意 Composio 工具包的 MCP 自动化范式声明式依赖requires.mcp→ 端点接入无 Key→ 连接授权与状态确认 → 动态工具发现 → schema 合规执行 → 会话与分页管理。仓库 composio-skills 目录下 832 个同构技能全部遵循这一范式因此本文所述的每一步操作——从RUBE_SEARCH_TOOLS的会话参数到RUBE_MULTI_EXECUTE_TOOL的memory必填约束——都可以原样平移到其余工具包技能中只需替换 toolkit 名称与 use case 描述。【免费下载链接】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），仅供参考
awesome-codex-skills 中的 DPD2 自动化技能：基于 Rube MCP（Composio）的物流工具集成实战
awesome-codex-skills 中的 DPD2 自动化技能基于 Rube MCPComposio的物流工具集成实战【免费下载链接】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本文以 awesome-codex-skills 仓库中的 dpd2-automation 技能文档 为主体完整讲解该 Codex Skill 的元数据、前置条件、Rube MCP 接入方式、三步核心工作流工具发现、连接检查、工具执行、已知陷阱与快速参考表。读完本文你将掌握如何在 Codex CLI 中通过 Rube MCP 连接 Composio 的 DPD2 工具包并以“先搜索、后执行”的规范模式驱动 DPD2 自动化操作。技能定位一个声明式 MCP 自动化技能该技能位于仓库的 composio-skills/ 技能族中。仓库内 composio-skills 目录下共包含 832 个按工具包命名的技能目录dpd2-automation 是其中之一对应 Composio 的 DPD2 工具包DPD2 是一款面向物流/运输场景的 SaaS 工具。技能的核心定义在 SKILL.md 的 YAML frontmatter 中--- name: dpd2-automation description: Automate Dpd2 tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各有明确职责这也符合仓库 README.md 中对 Codex 技能机制的说明——Codex 依据descriptionfrontmatter 判断何时触发技能并在触发后才加载正文从而保持上下文精简name: dpd2-automation技能唯一标识安装后作为$CODEX_HOME/skills/下的目录名description描述技能能力与触发时机并内嵌了最关键的行为约束——“Always search tools first for current schemas”始终先搜索工具以获取最新 schemarequires.mcp: [rube]声明该技能运行依赖名为rube的 MCP 服务器即 Rube MCPComposio 提供的 MCP 网关端点。从源码结构看该技能与同族的其他技能如 d2lbrightspace-automation采用完全一致的模板骨架仅工具包名称不同。这种统一结构意味着掌握了 dpd2 技能的用法即可迁移到仓库中其余 800 多个工具包技能上。前置条件Prerequisites文档明确要求满足以下三项前置条件后再运行任何工作流Rube MCP 已连接MCP 客户端中可用判据是RUBE_SEARCH_TOOLS工具可被调用并有响应存在活跃的 DPD2 连接通过RUBE_MANAGE_CONNECTIONS管理指定 toolkit 为dpd2始终以RUBE_SEARCH_TOOLS为第一步先拿到当前工具的最新 schema再执行后续动作。第 3 条是整个技能最重要的设计原则后文的陷阱清单中还有呼应工具 slug 和入参 schema 是动态的不允许硬编码。接入 Rube MCPSetup 流程文档给出的接入方式非常轻量在 MCP 客户端配置中将 Rube MCP 端点https://rube.app/mcp添加为一个 MCP 服务器即可文档明确说明无需 API Key——添加端点后直接可用。接入后的四步验证流程验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有响应发起连接管理调用RUBE_MANAGE_CONNECTIONStoolkit 指定为dpd2完成授权若连接状态不是 ACTIVE按接口返回的 auth link 完成授权设置确认状态在任何工作流执行前确认连接状态显示为 ACTIVE。这一步的价值在于把“认证”从本地配置转移到了远端工具链本地 Codex 不持有 DPD2 的任何凭据授权链接由 Rube MCP 侧生成凭据由 Composio 工具链托管。工具发现Tool Discovery执行任何工作流之前必须先发现可用工具。文档给出的标准调用是RUBE_SEARCH_TOOLS queries: [{use_case: Dpd2 operations, known_fields: }] session: {generate_id: true}其中两个参数值得注意queries是数组每项含use_case自然语言描述用例和可选的known_fields用自然语言描述具体任务如“查询 DPD2 运单状态”比泛化描述能拿到更贴合的工具列表session: {generate_id: true}表示由服务端生成本次会话 ID。该 session ID 是后续步骤复用的关键句柄见下文“会话复用”陷阱。调用返回内容包含四类信息可用工具的 slug、入参 schema、推荐执行计划recommended execution plans、已知陷阱known pitfalls。这决定了后续执行步骤中tool_slug与arguments的取值来源——一切以搜索结果的实时返回为准。核心工作流Core Workflow Pattern文档将完整工作流拆解为三步三步之间通过 session ID 串联。Step 1发现可用工具针对具体任务发起搜索并复用 Step 0工具发现生成的会话RUBE_SEARCH_TOOLS queries: [{use_case: your specific Dpd2 task}] session: {id: existing_session_id}与初始发现不同的是此处使用session: {id: existing_session_id}传入已有会话 ID而不是generate_id: true保证同一工作流内多轮工具调用共享同一上下文。Step 2检查连接状态在执行前确认 DPD2 连接处于 ACTIVERUBE_MANAGE_CONNECTIONS toolkits: [dpd2] session_id: your_session_idStep 3执行工具使用RUBE_MULTI_EXECUTE_TOOL批量执行已发现的工具。tool_slug取自 Step 1 搜索结果arguments必须严格符合搜索结果给出的 schemaRUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id注意tools同样是数组结构一次调用可携带多个工具执行项配合memory: {}参数即使为空也必须传入原因见陷阱清单。已知陷阱Known Pitfalls逐条解析文档列出了 6 条生产环境踩坑经验每一条都对应工作流中的具体约束Always search first始终先搜索工具 schema 会变化未经RUBE_SEARCH_TOOLS确认前严禁硬编码 tool slug 或参数。这是动态 MCP 工具链与静态 SDK 集成的本质区别Check connection检查连接执行工具前验证RUBE_MANAGE_CONNECTIONS返回 ACTIVE 状态避免在断连状态下批量报错Schema complianceschema 合规字段名与类型必须与搜索结果逐字一致不能凭记忆或类似工具包的经验拼参数Memory parametermemory 参数调用RUBE_MULTI_EXECUTE_TOOL时必须携带memory字段空对象{}也要显式传入——从调用契约看这是一个必填而非可选字段Session reuse会话复用同一工作流内复用 session ID新工作流才生成新会话。错误地频繁新建会话会丢失工作流内的上下文关联Pagination分页处理检查响应中的分页 token持续拉取直到数据完整避免只处理第一页结果。快速参考Quick Reference文档附带的操作速查表完整保留如下覆盖了从发现到执行、从批量到全量 schema 的常用路径操作方式查找工具RUBE_SEARCH_TOOLS使用 DPD2 相关的具体 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定dpd2执行工具RUBE_MULTI_EXECUTE_TOOL使用发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS速查表中还揭示了两个正文未展开的进阶能力RUBE_REMOTE_WORKBENCH支持通过run_composio_tool()做批量操作RUBE_GET_TOOL_SCHEMAS用于获取搜索结果中带schemaRef标记的工具的完整 schema——说明搜索返回的 schema 可能是引用式的需要二次拉取才能得到全量定义。在仓库中安装与验证该技能该技能遵循仓库标准的技能布局SKILL.md必备可选scripts/、references/、assets/子目录dpd2-automation 仅含一个 SKILL.md属于纯指令型技能。按仓库 README.md 的 Quickstart推荐用内置安装器安装git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills # 将 dpd2 技能安装到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/dpd2-automation也可以手动将composio-skills/dpd2-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/。两种方式的共同要求是安装或更新后重启 Codex以重新加载技能元数据。可用以下命令验证ls ~/.codex/skills # 确认技能目录存在 head ~/.codex/skills/dpd2-automation/SKILL.md # 确认 name/description frontmatter关于安装器行为skill-installer 技能文档 补充了几个实操细节若目标技能目录已存在会直接中止支持--ref默认main、--dest、--method auto|download|git选项下载失败且涉及权限错误时会回退到 git sparse checkout。小结dpd2-automation 技能的价值不在 DPD2 这一个工具包而在于它示范了一套适用于任意 Composio 工具包的 MCP 自动化范式声明式依赖requires.mcp→ 端点接入无 Key→ 连接授权与状态确认 → 动态工具发现 → schema 合规执行 → 会话与分页管理。仓库 composio-skills 目录下 832 个同构技能全部遵循这一范式因此本文所述的每一步操作——从RUBE_SEARCH_TOOLS的会话参数到RUBE_MULTI_EXECUTE_TOOL的memory必填约束——都可以原样平移到其余工具包技能中只需替换 toolkit 名称与 use case 描述。【免费下载链接】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），仅供参考