企业官网建设流程全解析

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

本指南完整解析 awesome-claude-skills 仓库中 composio-skills/brightpearl-automation/SKILL.md 所定义的 Brightpearl 自动化 Skill：它通过 Rube MCP（Composio 提供的 MCP 网关）将 Claude 与 Brightpearl 的官方工具集连接起来，让 AI 代理能够直接执行订单、库存、客户、采购等零售运营操作。读完本文，你将掌握「搜索工具 → 检查连接 → 执行调用」的完整工作流，并理解其中的关键参数、会话管理与常见陷阱。

Brightpearl 自动化 Skill 是什么

Brightpearl 是面向零售与电商业务的运营平台，其业务范围通常覆盖销售订单、库存管理、采购、客户与财务管理等零售运营核心流程（具体能力以 Composio Brightpearl 工具集中实际暴露的工具为准）。要让 Claude 这类 AI 代理真正「动手」操作 Brightpearl 而不是只生成建议，需要一个三层结构：

1. MCP 负责访问：Rube MCP 定义了代理与外部系统之间的连接方式（认证、传输、工具发现）；
2. Tools 负责动作：Composio 的 Brightpearl toolkit 提供了一个个可调用的具体函数；
3. Skill 负责行为：本 SKILL.md 规定了调用这些工具时的顺序、参数与守则。

本 Skill 正是把这三层串起来的「行为指南」。它位于仓库 composio-skills/ 目录下，与其余 78 个 SaaS 应用自动化 Skill 采用同一套模板模式——README 的 App Automation via Composio 一节明确说明，这些 Skill 均「使用从 Composio API 发现的真实工具 slug」，每条都包含工具序列、参数指导、已知陷阱与快速参考表。

Skill 元数据解读

SKILL.md 开头是 YAML frontmatter，它决定了 Skill 如何被代理加载与触发：

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

• name：Skill 唯一标识，会话开始时代理仅能看到名称与描述（约 100 token）；
• description：告诉代理何时激活本 Skill——当任务涉及 Brightpearl 操作时，同时内置了「始终先搜索工具以获得当前 schema」的强约束；
• requires.mcp：声明本 Skill 依赖名为rube的 MCP 服务器，提示客户端在加载前确保该 MCP 已接入。

前置条件

在运行任何 Brightpearl 工作流之前，必须满足三条前置条件（SKILL.md 原文即强调）：

• Rube MCP 必须已连接：环境中存在RUBE_SEARCH_TOOLS这一可用工具；
• Brightpearl 连接必须为 ACTIVE：通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为brightpearl的有效连接；
• 必须先调用RUBE_SEARCH_TOOLS：以获取当前最新的工具 schema，而非依赖记忆中的旧接口。

环境配置：接入 Rube MCP

接入 Rube MCP 非常简单，无需任何 API Key——只需在客户端配置中把https://rube.app/mcp添加为 MCP 服务器即可（这是 SKILL.md 原文明确说明的接入方式）。

随后按以下顺序完成验证与连接：

1. 验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS能正常响应；
2. 建立 Brightpearl 连接：调用RUBE_MANAGE_CONNECTIONS，传入 toolkitbrightpearl；
3. 完成认证：若连接状态不是 ACTIVE，点击返回的 auth 链接完成授权设置；
4. 确认状态：在任何工作流运行前，确认连接状态已变为 ACTIVE。

从仓库同类文档（如 composio-skills/composio-automation/SKILL.md）可以看出，这套「接入单一 MCP 端点 → 按 toolkit 建连 → 跟随 auth 链接授权」的流程是全部 78 个应用 Skill 共用的标准接入路径。

工具发现：永远先搜索

这是整个 Skill 的第一守则：执行任何工作流之前，先发现可用工具。标准的发现调用如下：

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

调用返回四类关键信息（SKILL.md 原文列举）：

• 可用工具的tool slugs（工具唯一标识）；
• 每个工具的输入 schema（字段名、类型、必填项）；
• 推荐执行计划；
• 该工具已知的坑（known pitfalls）。

use_case应描述你具体的 Brightpearl 任务，例如「创建销售订单」「查询库存水平」「更新客户信息」；known_fields用于提供你已经知道的字段以缩小搜索范围，首次可留空。session.generate_id: true表示让服务端生成一个新的会话 ID，适合工作流起点。

核心工作流模式：三步走

SKILL.md 给出了统一的三步工作流，任何 Brightpearl 任务都应遵循：

Step 1：发现可用工具

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

注意此处session传入的是已有的会话 ID（id），用于在同一工作流内保持上下文连续。

Step 2：检查连接

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

在真正执行工具前，必须确认 Brightpearl 连接处于 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复用 Step 1/2 的会话。

已知陷阱（Known Pitfalls）

SKILL.md 用专门一节总结了六条实践中必须遵守的规则，这也是本 Skill 最具实战价值的部分：

最后一条「分页」特别值得注意：Brightpearl 这类零售 ERP 的列表类操作（如订单列表、库存列表）往往分页返回，工作流设计时必须处理分页循环，否则会得到不完整的结果。

进阶工具：批量操作与完整 Schema

除了三步流程中的三个核心工具，SKILL.md 的快速参考还指出了两个进阶能力：

RUBE_REMOTE_WORKBENCH # 批量操作：使用 run_composio_tool() 函数 RUBE_GET_TOOL_SCHEMAS # 获取完整 schema：用于带 schemaRef 的工具

• 批量操作：当需要对多个 Brightpearl 记录执行同类操作时，用RUBE_REMOTE_WORKBENCH结合run_composio_tool()在远端工作台中批量执行，避免逐个调用RUBE_MULTI_EXECUTE_TOOL；
• 完整 Schema：部分工具在搜索结果中仅返回schemaRef引用，此时需要用RUBE_GET_TOOL_SCHEMAS拉取完整的参数定义后再构造arguments。

快速参考表

SKILL.md 收尾给出了完整的操作对照表，可直接作为开发时的速查卡：

在仓库中继续探索

本 Skill 是仓库中大规模应用自动化体系的一部分，你可以在以下位置继续深入研究：

• README.md：查看全部 78 个 SaaS 应用自动化 Skill 的分类清单（CRM、项目管理、沟通、电商与支付等）；
• composio-skills/：目录下每个子目录都是一个独立应用的同构 Skill，例如 composio-skills/composio-automation/SKILL.md，可用于对比理解模板的通用性与应用差异；
• connect/SKILL.md：基于 Composio 的通用「连接任意应用」Skill，展示了 Composio SDK 与 Claude Agent SDK 的代码级接入方式，可作为从 Skill 落到代码实现的桥梁。

总结

Brightpearl 自动化 Skill 的核心方法论可以浓缩为一句话：schema 会变、连接要查、参数要准、memory 要带、会话要省、分页要追。遵循「搜索 → 检查 → 执行」的三步模式，Claude 就能稳定可靠地操作 Brightpearl 的零售运营数据，而这一模式在 awesome-claude-skills 仓库的 78 个应用 Skill 中完全通用，学会一个即可迁移到其他所有应用。

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