heyreach-automation

heyreach-automation skill 概覽

heyreach-automation 的功能

heyreach-automation 是一個 Claude skill，可透過 Composio 的 Rube MCP server 執行 Heyreach 相關操作。它的核心做法不是猜測工具名稱，也不是依賴可能過期的 API 假設，而是先搜尋 Rube tools、確認目前有效的 Heyreach connection，再依照 Rube 回傳的最新 schema 執行選定的工作流程。

最適合 Sales Outreach 工作流程

heyreach-automation skill 最適合已使用 Heyreach 處理 Sales Outreach、並希望 AI 助手協助操作行銷活動相關任務的團隊；這樣就不必手動走完平台上的每一個步驟。當助理需要透過 Rube MCP 即時存取可用的 Heyreach toolkit，例如探索支援的操作、準備執行輸入、依工具驅動的計畫完成任務時，這個 skill 特別合適。

這個 skill 的差異點

它的關鍵差異不在於一大段 prompt template，而是強制採用「先探索、再執行」的工作流程。Heyreach 和 Composio 的 tool schema 可能會變動，因此這個 skill 會要求 agent 在執行前先呼叫 RUBE_SEARCH_TOOLS，並使用回傳的 tool slugs、schemas、execution plans 和 pitfalls。相較於一般「自動化 Heyreach」的 prompt，這種做法更安全，能降低幻覺出欄位或呼叫不可用 action 的風險。

採用前的重要需求

只有在你的 AI client 支援 MCP，且能連線到 Rube 時，這個 skill 才有實際意義。你也需要透過 RUBE_MANAGE_CONNECTIONS，使用 toolkit heyreach 建立有效的 Heyreach connection。若你的 client 無法使用 MCP tools，heyreach-automation 就無法發揮原本設計的價值。

如何使用 heyreach-automation skill

heyreach-automation 的安裝與設定路徑

從 Composio skill collection 安裝這個 skill：

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

接著在你的 client configuration 中加入 https://rube.app/mcp 作為 MCP server。上游 skill 註明 MCP endpoint 本身不需要 API keys，但你仍然必須透過 Rube 連接 Heyreach。先確認 RUBE_SEARCH_TOOLS 可用，再使用 toolkit heyreach 執行 RUBE_MANAGE_CONNECTIONS。在 connection status 變成 ACTIVE 之前，不要執行任何 outreach 操作。

這個 skill 需要你提供的輸入

像「do Heyreach automation」這種模糊請求，給 agent 的上下文太少。更好的 heyreach-automation 使用 prompt 應包含：

• 商業目標：campaign setup、lead handling、status review，或其他 Heyreach task
• 你關心的精確物件：campaign、lead list、account、inbox、sequence，或 report
• 任何限制：不要傳送訊息、只草擬變更、限制在指定 campaign、避免修改 active campaigns
• 期望輸出：直接執行任務、回傳計畫、摘要 tool options，或先請你確認

範例 prompt：「Use heyreach-automation for Sales Outreach. First discover current Heyreach tools with Rube. I want to review available actions for updating prospects in campaign Q1 SaaS Founders, but do not modify anything until I approve the exact tool call and fields.」

首次執行的建議流程

第一次使用時，先從不具破壞性的 discovery run 開始。請 agent 針對你的具體任務呼叫 RUBE_SEARCH_TOOLS，並在採取行動前說明可用工具。接著，讓它用 RUBE_MANAGE_CONNECTIONS 檢查 Heyreach connection。只有這兩步都完成後，才允許執行。

實務上可以照這個順序：

1. 「Search current Heyreach tools for this task.」
2. 「Show the returned schema and required fields.」
3. 「Confirm my Heyreach connection is active.」
4. 「Propose the exact tool call and risk level.」
5. 「Execute only after confirmation.」

這能降低呼叫失敗、意外變更 campaign，以及 schema 不相符造成的錯誤。

安裝前應先檢查的 repository 檔案

這個 skill 很精簡：主要要讀的檔案是 composio-skills/heyreach-automation 裡的 SKILL.md。提供的 tree 中沒有獨立的 README.md、scripts/、rules/、resources/ 或 references/ 資料夾，因此實際操作價值集中在 prerequisite、setup、tool discovery 和 core workflow 相關段落。安裝前，請先確認你的 agent environment 真的能公開 Rube MCP tools；否則單靠這個檔案本身並不會自動化 Heyreach。

heyreach-automation skill 常見問題

heyreach-automation 適合新手嗎？

只有在你的 client 已支援 MCP tools，或你熟悉 MCP server 設定時，它才算適合新手。它的工作流程描述很直觀，但 skill 依賴即時 tool calls，例如 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。非技術使用者可能需要協助完成初始 MCP 設定與 Heyreach 授權。

沒有 Heyreach 帳號也能使用嗎？

不行。這個 skill 是圍繞 Composio 的 Heyreach toolkit 設計的。你需要 Heyreach 帳號，並透過 Rube 建立有效 connection。沒有這個 connection 時，助理可以討論可能的工作流程，但無法執行真正的 Heyreach automation。

這比一般 prompt 好在哪裡？

一般 prompt 可能會編造 Heyreach API 欄位，或假設已過期的 action。heyreach-automation 會指示 agent 在行動前先探索目前的 tool schema。這對 Sales Outreach 操作尤其重要，因為錯誤欄位或非預期更新可能影響正在運作的 campaigns 和 prospect communication。

什麼情況不該使用這個 skill？

不要把它用在 Heyreach toolkit 以外、不受支援的 channels；也不要用在無法使用 MCP tools 的 client，或未經審核就全自動變更 campaign 的情境。如果你的目標只是撰寫 outreach copy，copywriting skill 可能更適合。heyreach-automation 最擅長的是需要透過 Rube 執行即時 Heyreach operations 的任務。

如何改進 heyreach-automation skill 的使用效果

提供更明確的 heyreach-automation 任務上下文

想得到更好的結果，請明確指定操作邊界。不要只說「update my campaign」，改成：「Search for tools that can inspect campaign settings. If a modification tool exists, show required fields and wait before changing anything.」這能幫助 skill 選擇正確的 Rube discovery query，並避免過早執行。

用確認節點控制風險

最重要的改進模式，是把 discovery、planning 和 execution 分開。任何 write action 之前都應要求確認節點，尤其是可能變更 campaigns、prospects、sending rules 或 account settings 的情境。你也可以要求「read-only first」，強制助理先收集可用選項，再進行變更。

留意常見失敗模式

常見阻礙包括 Heyreach connection status 未啟用、RUBE_SEARCH_TOOLS 不可用、目標太模糊、缺少 campaign identifiers，以及對 tool inputs 抱持過期假設。如果第一次嘗試失敗，不要只是重試。請 agent 針對更窄的 use case 重新執行 tool discovery，並將 required schema 與你提供的欄位逐一比對。

根據第一次輸出迭代

拿到第一次 tool discovery 結果後，請用 Rube 回傳的實際 tool names 和 required fields 改寫 prompt。例如：「Using the discovered schema, prepare the minimal safe call for this campaign, leave optional fields blank unless required, and explain any field you cannot infer.」這會把 heyreach-automation 從泛用的自動化助手，轉成可控的 Heyreach execution workflow。