企业官网建设流程全解析

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化

本篇技术指南以 postgrid-automation/SKILL.md 为核心，讲解如何通过 Composio 的 Postgrid 工具集（toolkit）与 Rube MCP，让 Claude 直接操作 Postgrid 完成信函与邮件自动化任务。读完本文，你将掌握从 Rube MCP 连接、Postgrid 授权、工具 schema 发现到"发现—检查—执行"三步工作流与分页/会话管理等完整实战方案，并理解为什么"永远先搜索工具"是这套自动化体系的最高原则。

Skill 定位：一份可加载的 Postgrid 自动化工作流

本 Skill 是 awesome-claude-skills 仓库中 "App Automation via Composio" 分类下的预构建工作流技能之一。根据仓库 README.md 的说明，这类技能为 78 个 SaaS 应用预先编排了"工具序列、参数指引、已知陷阱与快速参考表"，并且全部使用从 Composio API 发现的真实工具 slug（tool slug），而不是凭空编造的占位符。

从 SKILL.md 的 YAML frontmatter 可以看出其元数据结构：

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

• name：技能标识符，即postgrid-automation；
• description：技能描述，供 Agent 在会话启动阶段（仅加载名称与描述）判断是否激活本技能；
• requires.mcp：声明该技能依赖名为rube的 MCP 服务器，提示运行环境必须先就绪。

这份 frontmatter 体现了 Claude Skills 的加载机制：会话开始时 Agent 只看到技能的 name 与 description，只有判断任务与本技能相关时，才加载完整的 SKILL.md 正文指令。因此描述中特意强调 "Always search tools first for current schemas"，确保 Agent 在任何任务中都不会跳过工具发现环节。

前置条件：三件事缺一不可

在运行任何 Postgrid 工作流之前，必须确认以下三项前置条件：

1. Rube MCP 已连接：环境中必须存在可用的RUBE_SEARCH_TOOLS工具，这是整个自动化体系的入口；
2. Postgrid 连接处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS建立了 toolkit 为postgrid的活动连接；
3. 先搜索再执行：任何时刻都应先调用RUBE_SEARCH_TOOLS获取当前的工具 schema，而不是直接使用记忆中的工具名或参数。

第 3 点是本 Skill 反复强调的纪律：Composio 侧的工具 schema 会持续演进，硬编码工具 slug 或参数会直接导致执行失败。

安装与连接设置：四个步骤完成就绪

获取 Rube MCP：在客户端（Claude Code、Claude.ai 或其他支持 MCP 的 Agent）配置中添加https://rube.app/mcp作为 MCP 服务器端点。这一过程无需申请 API Key——只需把端点加进配置即可工作，OAuth 授权在后续连接管理步骤中按需触发。

端点配置完成后，按以下顺序验证连接状态：

1. 验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS能正常响应，说明 MCP 服务器已加载成功；
2. 发起 Postgrid 连接：调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为postgrid；
3. 完成授权（如需）：如果连接状态不是 ACTIVE，跟随返回的授权链接完成 OAuth 设置；
4. 确认状态：在运行任何工作流之前，确认连接状态显示为 ACTIVE。

这套流程与仓库中 connect/SKILL.md 描述的 Composio 连接模型一致：首次使用某个应用时走 OAuth 授权链接，授权完成后连接持久保留，后续工作流可复用。可以参考 connect-apps-plugin/README.md 中"首次使用应用时通过 OAuth 授权，之后即插即用"的说明来理解其底层机制。

工具发现：执行前的强制第一步

Rube MCP 提供RUBE_SEARCH_TOOLS用于动态发现可用工具。在开始任何工作流之前，先执行一次针对 Postgrid 的搜索：

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

调用返回的核心信息包括：

• 可用的工具 slug 列表（如信函创建、模板管理、批量投递等 Postgrid 操作对应的工具标识）；
• 每个工具的输入 schema：精确的字段名、类型与必填项；
• 推荐的执行计划：针对该 use case 的建议调用序列；
• 已知陷阱：该工具集常见的踩坑点，直接指导后续参数构造。

首次搜索时传入generate_id: true会为当前会话生成一个会话 ID；后续调用则复用该 ID（见下文的会话复用策略）。

核心工作流模式：发现 → 检查 → 执行

本 Skill 将 Postgrid 自动化收敛为一个稳定且可复用的三步工作流，每一步都有明确的 Rube MCP 调用方式。

Step 1：发现可用工具

针对具体任务发起搜索，并携带已建立的会话 ID：

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

use_case描述越具体，返回的工具 slug 与执行计划越精准。例如批量创建信函、查询投递状态、管理模板等任务，应分别使用对应的精确描述。

Step 2：检查连接

执行前确认 Postgrid 连接可用：

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

只有当返回状态为 ACTIVE 时才允许进入下一步。若连接过期或被撤销，需要回到安装设置环节重新授权。

Step 3：执行工具

使用RUBE_MULTI_EXECUTE_TOOL批量执行发现的工具：

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参数必须始终携带，即使为空也要传{}。

已知陷阱与最佳实践

本 Skill 明确列出了六条已知陷阱，它们共同构成了在 Rube MCP 上安全运行 Postgrid 工作流的行为准则：

• 永远先搜索（Always search first）：工具 schema 会变化。不调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数，是最常见的失败原因；
• 检查连接（Check connection）：执行工具前，必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE，避免对未授权或失效的连接发起调用；
• Schema 合规（Schema compliance）：使用搜索返回结果中的精确字段名与类型，任何近似字段名都会导致参数校验失败；
• Memory 参数（Memory parameter）：在RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory，即使为空（{}）。这是工具调用协议的一部分，缺省会导致调用不完整；
• 会话复用（Session reuse）：同一工作流内复用相同的会话 ID，保持上下文连续；只有开启全新工作流时才生成新的会话 ID；
• 分页处理（Pagination）：检查响应中是否携带分页 token（pagination token），若存在则继续翻页获取，直到数据取完为止，避免漏取大批量信函或模板数据。

快速参考表：一条命令对应一个操作

解读这张表的关键差异：

• 常规执行走RUBE_MULTI_EXECUTE_TOOL，适合单个或少量 Postgrid 操作；
• 批量操作改用RUBE_REMOTE_WORKBENCH，在其中通过run_composio_tool()以编程方式循环执行工具，适合大规模信函投递、批量模板更新等场景；
• 获取完整 schema：当搜索返回的工具带有schemaRef引用时，用RUBE_GET_TOOL_SCHEMAS拉取完整 schema 定义，补全嵌套对象的字段结构。

深入理解：Skill、MCP 与 Tools 三者的协作关系

要正确使用本 Skill，需要理解其所在的分层架构。根据仓库 README.md 的说明：MCP 定义 Agent 如何连接外部系统（认证、传输、工具发现）；Tools 是 Agent 实际调用的单个函数；Skills 则定义工作流——做什么、按什么顺序、带什么护栏。生产环境中三者同时运行：MCP 提供访问、Tools 提供动作、Skills 提供行为。

本 Skill 正是这一理念的落地：RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL属于 MCP 层提供的工具，而本 SKILL.md 则把"发现 → 检查 → 执行"编排成 Agent 遵循的行为序列。Postgrid 具体的能力（创建信函、管理模板、批量投递）并不在本 Skill 内硬编码，而是通过工具发现动态获取——这保证了即使 Postgrid 工具集升级，只要遵循"先搜索"纪律，工作流依然可用。

小结

postgrid-automationSkill 以极简的 frontmatter + 工作流指令，把 Postgrid 自动化收敛为一套纪律严明、可复用的执行范式：先通过RUBE_SEARCH_TOOLS获取当前 schema，再以RUBE_MANAGE_CONNECTIONS确认 ACTIVE 连接，最后用RUBE_MULTI_EXECUTE_TOOL按 schema 执行，全程遵守会话复用、memory 必带与分页续取规则。这套模式同样适用于仓库中其他 77 个 Composio 自动化技能——理解了 postgrid 的工作流，也就掌握了整套 Rube MCP 自动化体系的通用方法论。

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化