spoki-automation

spoki-automation skill の概要

spoki-automation の用途

spoki-automation は、Composio の Rube MCP toolkit を通じて Spoki の操作を実行するための Claude skill です。現在の Spoki tool schema をエージェントに検出させ、Spoki 接続を確認し、古い API 前提をハードコードせずに対応済みのワークフロー自動化タスクを実行したいユーザー向けに設計されています。

この skill の価値は、大量のプロンプト集ではありません。重要なのはワークフローの進め方です。まず Rube tools を検索し、spoki 接続を検証し、返された schema を確認してから、検証済みの入力で選択した action を実行します。

向いているユーザーとワークフロー

この spoki-automation skill は、すでに Claude と MCP、Composio/Rube を利用しているチームに向いています。特に、Spoki がメッセージング、カスタマーオペレーション、キャンペーン運用の一部になっている場合に役立ちます。実現したいビジネス上の結果は分かっているものの、正しい Spoki tool と最新の入力形式をエージェントに特定させたい場面に適しています。

たとえば、利用可能な Spoki action をエージェントに探させる、認証が有効か確認する、構造化された顧客データやキャンペーンデータから tool call を準備する、実行前に必要な fields を説明させる、といった使い方に向いています。

通常のプロンプトとの違い

汎用的なプロンプトでは、tool 名や schema を推測してしまうことがあります。spoki-automation は、まず RUBE_SEARCH_TOOLS を呼び出し、返された tool slugs、schemas、execution plans、pitfalls を使うようエージェントに明示します。MCP tool の公開内容は変わる可能性があり、古い例に基づく実行は自動化失敗のよくある原因になるため、これは重要です。

この skill は意図的に範囲を絞っています。Spoki 向けの接続認識型 Rube MCP ワークフローであり、単体の Spoki SDK、CLI、または完全なキャンペーン管理システムではありません。

spoki-automation skill の使い方

spoki-automation のインストール前提

Composio skills repository から skill をインストールします。

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

あわせて、Claude 互換クライアントで Rube MCP を設定しておく必要があります。MCP server として https://rube.app/mcp を追加し、MCP が RUBE_SEARCH_TOOLS を公開していることを確認してください。この skill は Rube に依存しているため、markdown だけをインストールしても十分ではありません。

実際の作業を始める前に、toolkit spoki に対して RUBE_MANAGE_CONNECTIONS を呼び出すようエージェントに依頼してください。接続が ACTIVE でない場合は、返された認証フローを完了してから、ステータスを再確認します。

skill に渡すべき入力

spoki-automation を安定して使うには、具体的なタスク、対象となる Spoki object またはワークフロー、データソース、制約、そして action を実行してよいのか、計画の準備だけに留めるのかをエージェントに伝えます。

弱いプロンプト:

Use Spoki to automate outreach.

よりよいプロンプト:

Use spoki-automation to discover the current Spoki tools via Rube MCP. Check my spoki connection first. I want to prepare a workflow for sending a WhatsApp-style customer update to a provided list, but do not execute until you show me the required fields, tool slug, schema, and any missing data.

このように書くと、エージェントは目的を現在の tools に対応付け、不足している fields を確認し、接続確認と schema 確認の前に実行してしまうことを避けられます。

インストール後の推奨ワークフロー

まず composio-skills/spoki-automation 内の SKILL.md から確認します。この skill で公開されているサポートファイルはこれだけです。そこには運用上の重要なルールが 3 つあります。Rube MCP が利用可能であること、Spoki 接続が有効であること、そしてワークフローの前に必ず RUBE_SEARCH_TOOLS を呼び出すことです。

実務では、次の順序で進めるとよいでしょう。

1. 具体的な Spoki タスクについて、tool を検索するようエージェントに依頼する。
2. 返された tool slugs、schemas、warnings を確認する。
3. spoki に対して RUBE_MANAGE_CONNECTIONS を確認するよう依頼する。
4. 必要な業務データを構造化された形式で渡す。
5. 顧客に影響する action の場合は、実行前に dry-run plan を依頼する。

実用的なプロンプト形式

次のような形式で依頼すると使いやすくなります。

Use the spoki-automation skill.

Goal: [specific Spoki outcome]
Execution mode: [plan only / execute after confirmation]
Data available: [fields, list source, IDs, message content, timing]
Constraints: [do not send duplicates, require approval, language, segment]
First steps: call RUBE_SEARCH_TOOLS for this exact use case, then check the spoki connection.
Output: show selected tool slug, required schema fields, missing inputs, and proposed execution steps.

これにより、エージェントが Spoki API の形を推測するのではなく、検出と検証に沿って作業を進めやすくなります。

spoki-automation skill FAQ

spoki-automation は初心者にも使いやすいですか？

MCP クライアントがすでに設定済みであれば、初心者にも扱いやすい skill です。ただし、ワンクリックで使える Spoki 自動化アプリではありません。tool へのアクセス許可、接続フローの完了、実行前の tool call 案の確認に慣れている必要があります。初めて使う場合は、まず “plan only” モードで実行するのがおすすめです。

この skill を使わないほうがよいケースは？

オフラインの Spoki ドキュメントが必要な場合、Rube MCP を使わずに直接 API コーディングの支援が必要な場合、または tool discovery の前に特定の action が必ず使える保証が必要な場合は、spoki-automation は適していません。この skill のガイダンスは live Rube schemas に依存するため、利用可否は実行時に決まります。

なぜ最初に tool discovery が必要なのですか？

この repository が RUBE_SEARCH_TOOLS を重視しているのは、Composio の tool schema が変わる可能性があるためです。最初に検索することで、エージェントは現在の tool 名、必須 fields、推奨 plan、既知の pitfalls を取得できます。これが、失敗しやすい、または安全でない自動化を防ぐための主なガードレールです。

Spoki 接続なしでも動きますか？

いいえ。接続ステータスの確認はこの skill で支援できますが、実際の Spoki 操作には RUBE_MANAGE_CONNECTIONS を通じた有効な spoki 接続が必要です。認証が未完了の場合、次にやるべきことは、モデルに何度も促すことではなく、返された auth link に従って認証を完了することです。

spoki-automation skill を改善する方法

タスクの伝え方を具体化して spoki-automation の結果を改善する

品質を大きく上げるには、あいまいな自動化依頼を運用ブリーフに変えることが重要です。対象者、メッセージまたは object の種類、元データ、必要な承認、実行タイミング、成功条件を含めてください。顧客に連絡する可能性があるタスクでは、送信前の確認ステップを明示的に必須にします。

改善例:

Before executing, summarize the exact records affected, the Spoki tool slug, required fields, and any defaults you will apply. Stop if any recipient identifier is missing.

よくある失敗を避ける

よくあるブロッカーは、Spoki 認証が有効でないこと、recipient や object identifier が不足していること、実行許可があいまいなこと、記憶にある tool schema を前提にしてしまうことです。対策は手順化です。tools を検索し、接続を確認し、必須 fields を検証し、ユーザーが plan を承認してから実行します。

エージェントが discovery を飛ばした場合は、次のように戻します。

Do not infer the schema. Call RUBE_SEARCH_TOOLS for this Spoki use case and base the next step only on the returned schema.

最初の出力後に見直す

最初の plan が出たら、すぐに実行を承認するのではなく、ギャップ確認を依頼します。役立つ追加質問の例は次のとおりです。

• “Which required fields are still missing?”
• “What records will be affected?”
• “What could cause duplicate or unintended sends?”
• “Show the final tool call inputs before execution.”

これにより、spoki-automation ガイドを単なる connector ではなく、より安全なワークフロー自動化のレビューループとして使えるようになります。

repository に追加するとよい改善点

上流の skill は、一般的な Spoki ユースケースの例、dry-run prompt template、非アクティブな Rube または Spoki 接続に関する troubleshooting notes があると、さらに使いやすくなります。セットアップ画面のスクリーンショットや、クライアント別の MCP 設定メモを含む小さな README.md も、新規ユーザーの導入ハードルを下げるのに役立ちます。