metaphor-automation

metaphor-automation skill 概览

metaphor-automation 能做什么

metaphor-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP 层执行 Metaphor 任务。它不会硬编码旧的工具名称或 schema，而是要求 agent 先发现当前可用的 Metaphor tools，验证用户的 Metaphor 连接状态，然后再使用 Rube 返回的 schema 执行选定操作。

因此，当你希望 AI agent 稳定地调用 Metaphor、而不是猜测当前到底存在什么 MCP tool 时，metaphor-automation skill 会非常有用。

最适合 Workflow Automation 用户

当你的 agent 需要在可重复流程中调用 Metaphor 时，适合把 metaphor-automation 用于 Workflow Automation：例如通过 Composio 搜索、检索、补全或处理由 Metaphor 管理的数据。它最适合已经在使用支持 MCP 的客户端，并且能够通过 Rube 授权 Metaphor 连接的用户。

如果只是把它当作独立的 prompt 库，它的价值就没那么大。它真正的优势来自实时 MCP 访问能力：RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS，以及通过 Composio 暴露出来的 Metaphor toolkit。

关键差异：先发现 schema

这个 skill 最重要的设计选择，是坚持要求 agent 在执行任何动作之前先调用 RUBE_SEARCH_TOOLS。这很关键，因为 MCP tool 的 schema 可能变化，不同账号可用的 action 也可能不同，而过期示例很容易导致调用失败。

从安装决策角度看，这是一个很实用的防护栏：metaphor-automation 并不是试图记住 Metaphor 的 API。它教 agent 先向 Rube 查询当前 tool list、input schema、execution plan 和潜在坑点，再执行工作流。

安装前需要确认什么

安装前，请确认你的环境可以使用 Rube MCP，并且你愿意授权 Metaphor toolkit 连接。上游 skill 很轻量，核心集中在 SKILL.md；当前没有随包提供的 scripts、examples、resources 或 test fixtures。这让接入更简单，但也意味着你的 prompt 必须提供足够的任务细节，因为 skill 无法自行推断这些信息。

如何使用 metaphor-automation skill

metaphor-automation 安装场景

从你的 skill manager 使用的 repository path 安装该 skill，例如：

npx skills add ComposioHQ/awesome-claude-skills --skill metaphor-automation

然后使用以下地址将 Rube MCP 添加到你的 AI client：

https://rube.app/mcp

该 skill 需要 rube MCP server。实际使用时，在期待 metaphor-automation 正常工作之前，先确认 RUBE_SEARCH_TOOLS 可用。如果缺少 MCP server，这个 skill 可以描述工作流，但无法执行 Metaphor action。

首次运行前的必要设置

一次成功的运行通常遵循这个顺序：

1. 确认 RUBE_SEARCH_TOOLS 有响应。
2. 使用 RUBE_MANAGE_CONNECTIONS，并指定 toolkit metaphor。
3. 如果连接状态不是 ACTIVE，打开返回的授权链接。
4. 在要求 agent 执行任务前，重新检查连接状态。
5. 要求 agent 针对你的具体 Metaphor 用例搜索 tools，而不只是笼统搜索 “Metaphor operations”。

最重要的接入阻塞点是连接状态。很多失败并不是 prompt 写得不好，而是缺少 MCP 访问能力，或 Metaphor 连接尚未激活。

把粗略目标改写成可执行 prompt

较弱的 prompt：

Use Metaphor to find some data.

更强的 prompt：

Use the metaphor-automation skill. First call RUBE_SEARCH_TOOLS for the exact use case: “find recent Metaphor records matching [topic/entity/filter] and return the top results with source fields.” Check the Metaphor connection with RUBE_MANAGE_CONNECTIONS. Use only the schema returned by Rube. Before executing, summarize the chosen tool, required inputs, optional filters, and any missing information you need from me.

这样能提升输出质量，因为它告诉了 agent 操作类型、实体或主题、预期结果结构，并明确要求不要编造字段。用于自动化时，还应补充 limits、date ranges、deduplication rules、output format，以及没有结果时应如何处理。

优先阅读的 repository 文件

先阅读 composio-skills/metaphor-automation/SKILL.md。它包含整个 skill 的内容：prerequisites、setup、tool discovery、connection checks，以及核心 workflow pattern。当前 skill path 下没有单独的 README.md、scripts/、references/ 或 resources/ 文件夹，因此不要期待在别处有隐藏实现细节。

如果需要更深入的产品背景，可以查看 skill 中链接的 Composio Metaphor toolkit 文档：https://composio.dev/toolkits/metaphor。

metaphor-automation skill 常见问题

没有 Rube MCP，metaphor-automation 够用吗？

不够。metaphor-automation skill 依赖客户端中可用的 Rube MCP。没有 RUBE_SEARCH_TOOLS，最关键的行为——发现当前 Metaphor tools 和 schemas——就无法发生。没有 RUBE_MANAGE_CONNECTIONS，agent 也无法验证 Metaphor toolkit 是否已授权。

它比普通 prompt 好在哪里？

普通 prompt 可能只是要求模型“use Metaphor”，但模型可能幻觉出不存在的 tool name、过期参数或不受支持的 action。metaphor-automation 给 agent 一个更安全的执行模式：先发现 tools，再检查连接，查看 schemas，最后运行选定 tool。对于实时 Workflow Automation 来说，这比单纯的静态指令更可靠。

适合初学者吗？

如果你已经知道如何把 MCP server 添加到 AI client，它对初学者是友好的。但如果你从未配置过 MCP 或 OAuth-style tool connection，它并不是最理想的起点。这个 skill 的文档很短，因此初学者需要准备好跟随 Rube connection flow 操作，并在执行前要求 agent 解释每个返回的 tool schema。

什么时候不应该使用这个 skill？

如果你只是想围绕 Metaphor 做一般性头脑风暴，或者你的 client 无法连接 MCP servers，或者你的工作流需要本地 scripts 和 validations，而该 skill 并不提供这些能力，那么不要使用 metaphor-automation。若你需要固定、经过审计的 API wrapper，也应避免使用它；这个 skill 有意依赖实时的 Rube tool discovery。

如何改进 metaphor-automation skill

改进 metaphor-automation 输入

想获得最佳结果，关键是把任务描述得足够精确。请包含：

• 你需要的具体 Metaphor operation
• entity names、query terms、filters 或 IDs
• 预期 output fields
• result limits 和 sort preferences
• agent 是否可以执行 action，还是只能准备 plan
• 当 schema 缺少某个目标字段时的 fallback behavior

这样可以减少不必要的 tool searches，并避免 agent 把一个宽泛的 research request 当成可执行的 automation step。

避免常见失败模式

最常见的失败包括跳过 discovery、连接未激活、猜测 schema，以及用户目标过于模糊。请明确告诉 agent：

Do not call any Metaphor tool until RUBE_SEARCH_TOOLS has returned the current schema and RUBE_MANAGE_CONNECTIONS confirms an active Metaphor connection.

如果调用失败，要求 agent 将尝试使用的 input 与 Rube 返回的 schema 对照检查，而不是依据记忆或旧示例判断。

首次输出后继续迭代

第一次运行后，可以要求 agent 给出 execution note 来改进工作流：selected tool slug、used required fields、omitted optional fields、returned errors，以及 recommended next call。这样可以把一次性执行沉淀成团队可复用的 metaphor-automation 指南。

对于重复性工作流，请保存一套成功的 prompt pattern，包含你的必需 filters、output format 和 approval checkpoints。

为你的环境安全扩展 skill

如果你维护 fork，可以添加与你真实用例匹配的 examples：search templates、connection-check snippets、expected outputs 和 error-handling rules。保持“先搜索 tools”的核心行为不变。最大的改进不是写更多说明文字，而是加入组织特定的 prompts，让 tool discovery 更有针对性，让执行更少歧义。