awesome-codex-skills：基于 Rube MCP 的 Deadline Funnel 自动化 Skill 接入与执行指南-港品优选

awesome-codex-skills：基于 Rube MCP 的 Deadline Funnel 自动化 Skill 接入与执行指南

【免费下载链接】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

本文以 deadline-funnel-automation 技能文档为核心，讲解如何在 Codex 中通过 Rube MCP（Composio）接入并自动化操作 Deadline Funnel 这一邮件营销/漏斗类 SaaS 服务。读完后，你将掌握该 Skill 的前置条件、MCP 服务端点配置、"先发现工具、再检查连接、最后执行"的标准三步工作流，以及官方文档明确列出的六类常见陷阱和快速参考命令。

Skill 定位与元数据解读

该 Skill 位于仓库的 composio-skills/deadline-funnel-automation/SKILL.md，其职责单一而明确：让 Codex 通过 Composio 的 Deadline Funnel 工具集（toolkit）执行真实业务操作，而不是只生成"可以怎么做"的建议文本。

文档开头的 YAML frontmatter 定义了技能的触发与依赖信息：

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

name：技能在$CODEX_HOME/skills目录下的唯一标识；
description：决定 Codex 何时触发该技能。按 README.md 中"What Are Codex Skills?"一节的说明，Codex 读取元数据判断是否触发，命中后才加载正文，从而保持上下文精简；
requires: mcp: [rube]：声明该技能依赖名为rube的 MCP 服务器，这是本文所有工具调用（RUBE_*系列）的通道。

前置条件与 Rube MCP 接入

三条前置条件

原文档列出的前提如下：

Rube MCP 必须已连接（即RUBE_SEARCH_TOOLS工具可用）；
必须通过RUBE_MANAGE_CONNECTIONS建立对 toolkitdeadline_funnel的活跃（ACTIVE）连接；
任何工作流执行前，必须先调用RUBE_SEARCH_TOOLS获取当前工具 schema。

第三条是该技能最核心的设计原则：工具 schema 会变化，绝不允许凭记忆硬编码工具名和参数。

配置步骤

Rube MCP 的接入方式在文档中被描述为"零 API Key"——只需在客户端 MCP 配置中加入端点即可：

MCP server 端点：https://rube.app/mcp

完成端点配置后，按以下四步完成初始化：

确认RUBE_SEARCH_TOOLS有响应，以此验证 Rube MCP 可用；
调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为deadline_funnel；
若连接状态不是 ACTIVE，按返回的 auth 链接完成授权流程；
再次确认连接状态为 ACTIVE 之后，才允许运行任何工作流。

工具发现：RUBE_SEARCH_TOOLS

在首次接入或开启新工作流时，先做一次工具发现调用：

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

参数说明：

queries[].use_case：自然语言描述当前用途，首次接入时用"Deadline Funnel operations"这类通用表述，后续可细化为具体任务；
queries[].known_fields：可留空字符串；
session: {generate_id: true}：请求服务端生成一个会话 ID，供后续同一工作流内的调用复用。

该调用的返回内容包括：可用工具的 slug、输入 schema、推荐的执行计划（recommended execution plans）以及已知陷阱（known pitfalls）。这些返回结果是后续第 3 步执行调用时构造参数的唯一依据。

核心工作流：发现 → 检查连接 → 执行

Step 1: Discover Available Tools

用具体的任务描述重新搜索，并复用 Step 0 获得的会话 ID：

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

Step 2: Check Connection

执行前核对deadline_funnel工具集的连接状态：

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

Step 3: Execute Tools

拿到搜索返回的 slug 与 schema 后，通过多工具执行接口发起真实调用：

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 完全一致；
memory参数即使无内容也要显式传空对象{}，session_id沿用同一工作流的会话。

已知陷阱（Known Pitfalls）

原文档"Known Pitfalls"一节列出了六条，逐条完整继承并补充说明：

陷阱	文档要求	说明
Always search first	工具 schema 会变，未经`RUBE_SEARCH_TOOLS`不得硬编码 slug 或参数	防止上游工具升级后参数失效
Check connection	执行工具前用`RUBE_MANAGE_CONNECTIONS`确认 ACTIVE 状态	避免未授权连接直接报错
Schema compliance	严格使用搜索结果中的字段名与类型	字段大小写、命名风格偏差都会导致调用失败
Memory parameter	`RUBE_MULTI_EXECUTE_TOOL`必须包含`memory`，即使为空`{}`	这是接口契约要求，不是可选字段
Session reuse	同一工作流内复用 session ID，新工作流再生成新 ID	保证服务端会话上下文连续
Pagination	检查响应中的分页 token，持续拉取直到完整	列表类工具的数据必须取全

快速参考表

原文档 Quick Reference 全表如下：

操作	方式
查找工具	`RUBE_SEARCH_TOOLS`，携带 Deadline Funnel 专属 use_case
建立连接	`RUBE_MANAGE_CONNECTIONS`，toolkit 为`deadline_funnel`
执行工具	`RUBE_MULTI_EXECUTE_TOOL`，使用发现阶段得到的 slug
批量操作	`RUBE_REMOTE_WORKBENCH`，配合`run_composio_tool()`
获取完整 schema	对带`schemaRef`的工具调用`RUBE_GET_TOOL_SCHEMAS`

前三个操作覆盖日常 90% 的场景；RUBE_REMOTE_WORKBENCH面向批量任务，RUBE_GET_TOOL_SCHEMAS则在搜索返回的 schema 只是schemaRef引用（未展开）时用于取回完整定义。

在仓库中的位置：安装与触发机制

按 README.md 的约定，技能目录整体放入$CODEX_HOME/skills（默认~/.codex/skills），每个子目录包含一个带name与descriptionfrontmatter 的SKILL.md，安装后需重启 Codex 才会加载新元数据。

两种安装方式：

使用仓库自带的安装脚本（推荐）：

python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/deadline-funnel-automation

该命令会将技能落到$CODEX_HOME/skills/deadline-funnel-automation。脚本的行为（下载失败回退 sparse checkout、目标目录已存在则中止等）在 skill-installer/SKILL.md 中有完整说明。

手动安装：将composio-skills/deadline-funnel-automation目录复制到$CODEX_HOME/skills/下，重启 Codex。

安装完成后的验证方式：ls ~/.codex/skills查看目录、head ~/.codex/skills/deadline-funnel-automation/SKILL.md查看元数据。在会话中描述 Deadline Funnel 相关任务时，Codex 会依据description自动触发该技能；也可以直接点名deadline-funnel-automation强制其参与。

与同族 Skill 的关系：统一的 Rube MCP 模板

从源码结构看，composio-skills/ 目录下有数百个*-automation技能，它们共享同一套 Rube MCP 模板。例如 composio-skills/composio-automation/SKILL.md 与 composio-skills/composio-search-automation/SKILL.md 的正文结构与本技能逐节对应，差异仅在于 frontmatter 中的技能名和RUBE_MANAGE_CONNECTIONS的 toolkit 取值。这意味着本文总结的三步工作流、陷阱清单和快速参考表可以平移到仓库中其它 Composio 工具集技能——只需把 toolkit 名称替换为目标服务的标识。

此外，仓库还提供了另一条不依赖 Rube MCP 的路径：connect/SKILL.md 演示用 Composio CLI（composio search/composio link/composio execute）在终端直接执行跨应用操作。两者对比：

维度	deadline-funnel-automation（本文）	connect
通道	Rube MCP（`RUBE_*`工具调用）	Composio CLI 命令
鉴权	端点连接 + auth 链接授权，文档称无需 API Key	`composio login`浏览器授权 +`composio link <toolkit>`
工具发现	`RUBE_SEARCH_TOOLS`（返回 schema 与执行计划）	`composio search`/`composio execute --get-schema`
适用形态	Agent 会话内以工具调用方式编排	终端脚本化、可`--dry-run`预检

选择 Rube MCP 路径的好处是会话内闭环：发现、连接检查、执行都在 MCP 工具调用中完成，并通过session参数保持上下文。

适用前提与限制

本技能的全部能力依赖 Rube MCP 端点可用，以及deadline_funnel工具集的 ACTIVE 连接；两者缺一，RUBE_MULTI_EXECUTE_TOOL均无法执行；
文档明确声明端点接入"无需 API Key"，但业务授权仍需通过RUBE_MANAGE_CONNECTIONS返回的 auth 链接完成；
工具 slug 与参数结构以RUBE_SEARCH_TOOLS的实时返回为准。上游 Composio 工具集迭代后，本文示例中的调用字段可能需要同步更新；
文档未涉及 Deadline Funnel 各业务功能（如邮件列表管理、活动创建等）的具体参数示例，实际参数请以搜索返回的 schema 为准构造。

综上，deadline-funnel-automation 的价值在于提供了一套可复制的"发现—连接—执行"自动化范式：以RUBE_SEARCH_TOOLS的实时 schema 为唯一事实来源，以会话复用与连接检查为可靠性护栏，把 Deadline Funnel 的操作从"生成建议文本"推进到"真实执行 API 调用"。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析