企业官网建设流程全解析

awesome-codex-skills 中的 Placekey 自动化：通过 Rube MCP 与 Composio 驱动场所标识解析

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

Placekey 是面向物理场所的通用标识符标准，能为任意地点生成稳定、唯一的标识，广泛用于 POI 去重、多源地理数据对齐与地址解析等场景。本指南以 composio-skills/placekey-automation/SKILL.md 为骨架，完整讲解如何通过 Rube MCP（Composio 的 MCP 网关）在 Codex 中自动化 Placekey 操作——包括环境接入、连接管理、工具发现、执行工作流与踩坑规避。读完本文，你将掌握一套"搜索工具 → 检查连接 → 执行调用"的标准自动化范式，并理解其背后的原理与边界。

一、技能文件定位与设计思路

该技能位于仓库的composio-skills/目录下，遵循 awesome-codex-skills 项目统一的 Codex Skill 规范：每个技能独立成目录，内含带 YAML frontmatter 的SKILL.md。打开 placekey-automation/SKILL.md 可以看到其元信息：

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

其中description决定了 Codex 何时自动触发该技能（根据 README 的说明，Codex 依据描述与任务的匹配度来选择技能），而requires.mcp: [rube]声明了运行前提——必须接入 Rube MCP 服务器。整个技能的核心方法论是"永远先搜索工具 schema 再执行"，这一点贯穿了后续所有章节。

二、前置条件与 Rube MCP 接入

在执行任何 Placekey 自动化之前，需要满足三个前置条件：

• Rube MCP 必须已连接，且RUBE_SEARCH_TOOLS工具可用；
• 存在活跃的 Placekey 连接：通过RUBE_MANAGE_CONNECTIONS建立，toolkit 名称为placekey；
• 每次执行前先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema。

Rube MCP 是什么

Rube MCP 是 Composio 提供的 MCP 端点，地址为https://rube.app/mcp。把它作为 MCP server 添加到 Codex（或其他 MCP 客户端）的配置中即可使用，无需任何 API key——只需添加端点即可工作。这一点大大降低了接入门槛：你不需要在代码中管理凭证，认证由连接（Connection）层统一处理。

建立 Placekey 连接的四步流程

1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds 2. Call RUBE_MANAGE_CONNECTIONS with toolkit placekey 3. If connection is not ACTIVE, follow the returned auth link to complete setup 4. Confirm connection status shows ACTIVE before running any workflows

关键在第三步：当连接状态不是ACTIVE时，RUBE_MANAGE_CONNECTIONS会返回一个认证链接，按链接完成授权后连接即生效。必须确认状态为 ACTIVE 才能开始跑工作流，否则后续工具调用会因缺少凭证而失败。

三、工具发现：为什么"永远先搜索"

RUBE_SEARCH_TOOLS是本技能中最重要的一环。文档给出的发现示例：

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

该调用会返回：可用的工具 slug（tool_slug）、输入 schema、推荐的执行计划，以及已知的坑点（known pitfalls）。这正是 Rube MCP 设计上的核心思路——Composio 平台上的工具 schema 会随版本演进，硬编码工具名或参数极易失效，因此技能强制要求运行时动态获取。

从仓库证据看，这一约定并非 placekey 独有：composio-skills/composio-automation/SKILL.md 与 composio-skills/google-maps-automation/SKILL.md 等数百个 composio-skills 技能均遵循同一模板，所有技能文件都同样强调"Always search tools first"。可以推断，Rube MCP 的工具集是统一、集中式维护的，任何 Placekey 相关的新工具或参数变更都会通过RUBE_SEARCH_TOOLS动态暴露给 Agent。

四、核心工作流模式（三步法）

技能定义了三步式标准工作流，这是实际自动化 Placekey 任务时的主流程：

Step 1：发现可用工具

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

把use_case换成具体的任务描述（例如按地址解析 Placekey、批量场所去重等），并复用已有会话 ID。

Step 2：检查连接状态

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

确认placekeytoolkit 的连接仍处于ACTIVE，防止会话过期导致的隐性失败。

Step 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必须来自 Step 1 的搜索结果，不可臆造；
• arguments必须严格符合搜索返回的 schema（字段名、类型都要一致）；
• memory参数必须始终携带，即使为空也要传{}；
• session_id沿用前两步的会话，保持工作流上下文连续。

五、Rube 工具族全景速查

除三步法中的三个工具外，技能还提及了另外两个高级工具，完整映射如下：

其中RUBE_REMOTE_WORKBENCH适合批量处理场景——当需要对大量地址做 Placekey 解析（例如清洗整个商户库）时，单条RUBE_MULTI_EXECUTE_TOOL逐一调用效率较低，可改用 Workbench 方式批量执行。而RUBE_GET_TOOL_SCHEMAS用于深度集成：当搜索结果中的 schema 以schemaRef形式引用时，用它拉取完整定义，适合需要精确构造参数的程序化调用。

六、已知坑点：六个必须遵守的纪律

技能文档明确列出了六类高频问题，这也是该技能实战价值最集中的体现：

1. 永远先搜索：工具 schema 会变化。未经RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数，是失败的首要来源；
2. 检查连接：执行前务必通过RUBE_MANAGE_CONNECTIONS确认连接为ACTIVE；
3. schema 合规：使用搜索结果中的精确字段名与类型，不要凭记忆拼参数；
4. memory 参数：RUBE_MULTI_EXECUTE_TOOL调用必须包含memory，即使为空对象{}；
5. 会话复用：同一工作流内复用 session ID；新工作流生成新 ID（对应文档中的session: {generate_id: true}用法）；
6. 分页处理：检查响应中的分页 token，持续拉取直到数据完整——大批量解析结果时尤其容易遗漏。

七、将本技能安装到 Codex

该技能属于 awesome-codex-skills 仓库（见 README.md），安装方式与仓库内其他技能一致：

• 推荐：使用技能安装器。仓库提供了 skill-installer 辅助脚本，可基于仓库路径自动将技能安装到$CODEX_HOME/skills（默认~/.codex/skills）；
• 手动安装：将composio-skills/placekey-automation/整个目录复制到$CODEX_HOME/skills/下；
• 安装或更新后重启 Codex使其重新加载元数据，然后在会话中自然描述任务，Codex 会根据description自动触发该技能。

八、总结

placekey-automation技能展示了"运行时工具发现 + 托管连接 + 会话化执行"这一现代 MCP 自动化范式的完整落地：接入 Rube MCP 零 API key，连接管理交给RUBE_MANAGE_CONNECTIONS，工具契约以RUBE_SEARCH_TOOLS动态获取，执行统一走RUBE_MULTI_EXECUTE_TOOL。对于希望以最低成本、最高健壮性在 Codex 中自动化 Placekey（乃至任何 Composio 集成）的开发者，直接复用 composio-skills/placekey-automation/SKILL.md 中记载的工作流与纪律，即可快速落地可复用的自动化管线。

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