metaphor-automation
作者 ComposioHQmetaphor-automation 可協助代理透過 Composio Rube MCP 執行 Metaphor 工作流程；它會先探索目前可用工具、檢查連線狀態，並在執行前使用即時 schemas。
此 skill 評分為 67/100，代表可收錄於目錄，但應定位為輕量的連接器型 skill，而不是完整成熟的工作流程套件。目錄使用者可以理解何時安裝它——也就是透過 Rube MCP 進行 Metaphor 自動化——但實際操作與 schemas 仍需依賴即時工具探索與外部 toolkit 文件。
- 觸發條件與適用範圍清楚：用於透過 Rube MCP，使用 Composio 的 Metaphor toolkit 自動化 Metaphor 操作。
- 操作前提交代明確，包括可用的 Rube MCP、有效的 Metaphor 連線，以及必須先呼叫 RUBE_SEARCH_TOOLS 取得目前 schemas。
- 提供基本執行模式，涵蓋工具探索、連線檢查與依 schema 使用工具；相較一般提示詞，應可減少摸索成本。
- 工作流程指引多半偏向 Rube MCP 的探索／執行通用流程，缺少具體的 Metaphor 任務範例或常見操作示例。
- 除了 SKILL.md 之外，沒有支援檔案、README、安裝指令或本機參考資料；是否容易採用，取決於使用者是否已熟悉 Rube MCP 與 Metaphor/Composio 連線。
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 的 client，且能透過 Rube 授權 Metaphor 連線的使用者。
它比較不適合作為單純的 prompt library。這個 skill 的價值來自即時 MCP 存取能力：RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS，以及透過 Composio 暴露出的 Metaphor toolkit。
關鍵差異：先探索 schema
這個 skill 最重要的設計選擇，是堅持要求 agent 在採取行動前先呼叫 RUBE_SEARCH_TOOLS。這點很重要，因為 MCP tool schema 可能會變動、可用操作可能因帳號而異，而過期範例很容易導致呼叫失敗。
以安裝決策來看，這是一個實用的防護機制：metaphor-automation 並不是要記住 Metaphor 的 API。它是教 agent 在執行 workflow 前，先向 Rube 詢問目前的工具清單、input schema、執行計畫與可能踩雷之處。
安裝前應先確認的事項
安裝前，請確認你的環境能使用 Rube MCP，且你願意授權 Metaphor toolkit 連線。上游 skill 本身很精簡，核心集中在 SKILL.md；目前沒有隨附 scripts、examples、resources 或 test fixtures。這讓導入變得簡單，但也代表你的 prompts 必須提供足夠任務細節，因為 skill 無法自行推斷所有情境。
如何使用 metaphor-automation skill
metaphor-automation 安裝情境
請從你的 skill manager 所使用的 repository path 安裝，例如：
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 可以描述 workflow，但無法實際執行 Metaphor actions。
第一次執行前的必要設定
一次成功的執行通常會依照以下順序：
- 確認
RUBE_SEARCH_TOOLS有回應。 - 使用
RUBE_MANAGE_CONNECTIONS，並指定 toolkitmetaphor。 - 如果連線狀態不是
ACTIVE，開啟回傳的授權連結。 - 在要求 agent 執行任務前，重新檢查連線狀態。
- 要求 agent 針對你的具體 Metaphor 使用情境搜尋 tools，而不是只說「Metaphor operations」。
導入時最常見的阻礙是連線狀態。許多失敗並不是 prompt 品質不佳，而是缺少 MCP 存取權，或 Metaphor connection 尚未啟用。
把粗略目標改寫成可用 prompt
較弱的 prompt：
Use Metaphor to find some data.
較好的 prompt：
Use the metaphor-automation skill. First call
RUBE_SEARCH_TOOLSfor the exact use case: “find recent Metaphor records matching [topic/entity/filter] and return the top results with source fields.” Check the Metaphor connection withRUBE_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.
這樣能提升輸出品質，因為它提供了操作類型、entity 或 topic、預期結果格式，以及不要自行發明欄位的規則。若是自動化流程，請再補上 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 依賴 client 中可用的 Rube MCP。沒有 RUBE_SEARCH_TOOLS，最重要的行為——探索目前的 Metaphor tools 與 schemas——就無法發生。沒有 RUBE_MANAGE_CONNECTIONS，agent 也無法確認 Metaphor toolkit 是否已授權。
這比一般 prompt 好在哪裡？
一般 prompt 可能只會要求模型「use Metaphor」，但模型可能幻覺出工具名稱、過期參數或不支援的 actions。metaphor-automation 會給 agent 一套更安全的執行模式：探索 tools、檢查 connection、檢視 schemas，然後再執行選定的 tool。相較於只有靜態指令，這更適合需要即時執行的 Workflow Automation。
適合初學者嗎？
如果你已經知道如何把 MCP server 加到 AI client，這個 skill 對初學者算友善。但如果你從未設定過 MCP，或 OAuth 類型的工具連線，它就不太適合作為第一個入門項目。這個 skill 的文件很短，因此初學者需要準備好依照 Rube connection flow 操作，並在執行前要求 agent 解釋每個回傳的 tool schema。
什麼時候不該使用這個 skill？
如果你只需要針對 Metaphor 做一般性的腦力激盪、你的 client 無法連到 MCP servers，或你的 workflow 需要本機 scripts 與 validations，而這個 skill 並未提供，那就不適合使用 metaphor-automation。此外，如果你需要固定且已審計的 API wrapper，也應避免使用；這個 skill 的設計本來就是刻意依賴即時 Rube tool discovery。
如何改進 metaphor-automation skill
改善 metaphor-automation inputs
最好的結果來自清楚精準的任務描述。請包含：
- 你想執行的確切 Metaphor operation
- entity names、query terms、filters 或 IDs
- 預期的 output fields
- result limits 與 sort preferences
- agent 可以實際採取行動，還是只能準備 plan
- schema 缺少某個想要欄位時的 fallback behavior
這能減少不必要的 tool searches，也能避免 agent 把寬泛的研究請求誤當成可直接執行的自動化步驟。
避免常見失敗模式
最常見的失敗包括略過 discovery、connection 未啟用、猜測 schemas，以及使用者目標太模糊。請明確告訴 agent：
Do not call any Metaphor tool until
RUBE_SEARCH_TOOLShas returned the current schema andRUBE_MANAGE_CONNECTIONSconfirms an active Metaphor connection.
如果呼叫失敗，請要求 agent 將已嘗試的 input 與 Rube 回傳的 schema 進行比對，而不是依賴記憶或舊範例。
第一次輸出後持續迭代
第一次執行後，可以要求 agent 提供 execution note 來改進 workflow：selected tool slug、required fields used、optional fields omitted、returned errors，以及 recommended next call。這能把一次性的執行，轉化成團隊可重複使用的 metaphor-automation 指南。
對於會重複使用的 workflows，請保存一套成功的 prompt pattern，包含你的 required filters、output format 與 approval checkpoints。
安全地依環境擴充 skill
如果你維護自己的 fork，請加入符合實際使用情境的 examples：search templates、connection-check snippets、expected outputs，以及 error-handling rules。務必保留核心的「search tools first」行為。最大的改進不會是增加更多說明文字，而是加入符合組織需求的 prompts，讓 tool discovery 更有方向、執行時更少歧義。