veriphone-automation

veriphone-automation skill の概要

veriphone-automation でできること

veriphone-automation は、Composio の Rube MCP toolkit 経由で Veriphone タスクを実行するための Claude skill です。中心にある重要なルールは、「Veriphone のツール名や入力スキーマが常に同じだと決めつけない」ことです。この skill は、まず Rube のツールを検索し、Veriphone の接続を確認してから、Rube が返す最新スキーマに基づいて適切なツールを実行するようエージェントに指示します。

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

この skill は、Veriphone を使った電話番号のインテリジェンス取得や検証が必要で、MCP のツール探索と実行手順を AI エージェントに任せたい場合に役立ちます。たとえば、リードの電話番号を確認するオペレーションチーム、顧客レコードを補完するサポートチーム、自動化に電話番号検証を組み込みたいワークフロー構築者、Composio toolkit のすべてのスキーマを手作業で読むことなく Veriphone アクションを試したい開発者に適しています。

通常のプロンプトではなく skill を使う理由

一般的なプロンプトでモデルに「Veriphone を使って」と依頼することはできますが、その場合、存在しないツール名を作ったり、接続確認を飛ばしたり、古いパラメータを使ったりするリスクがあります。veriphone-automation skill は、より安全な実行パターンをエージェントに与えます。具体的には、Rube MCP が利用できることを確認し、veriphone 接続を管理し、RUBE_SEARCH_TOOLS を呼び出し、返されたスキーマを確認してから、該当する操作だけを実行します。

インストール前に理解しておきたい主要な依存関係

この skill は、単体で動くローカルスクリプトではなく Rube MCP に依存しています。MCP 対応クライアント、https://rube.app/mcp へのアクセス、そして Rube で管理された有効な Veriphone 接続が必要です。利用環境で MCP ツールを使えない場合、この skill 単体では実用的な処理は行えません。

veriphone-automation skill の使い方

veriphone-automation のインストールとセットアップ前提

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

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

次に、AI クライアントに Rube MCP を MCP server として追加します。

https://rube.app/mcp

インストール後、クライアントが RUBE_SEARCH_TOOLS を公開していることを確認します。toolkit に veriphone を指定して RUBE_MANAGE_CONNECTIONS を使い、接続が有効かどうかを確認してください。Rube が認証リンクを返した場合は、エージェントに Veriphone 操作を依頼する前に認証フローを完了します。

skill に渡すべき入力情報

veriphone-automation を安定して使うには、実行したいタスク、電話番号データ、希望する出力形式、適用すべきポリシー上の制約をエージェントに明確に伝えてください。「この番号をチェックして」のような曖昧な指示は避けます。より良いプロンプトは次のようなものです。

Use the veriphone-automation skill to validate these phone numbers through the Veriphone toolkit. First search Rube tools for the current schema, confirm the Veriphone connection is active, then return a table with input number, validity status, country, carrier or line-type fields if available, and any error messages. Do not guess missing fields.

本番データを処理する場合は、バッチ処理の想定、エラー時に停止するかどうか、無効または不完全な電話番号をどう扱うかも含めてください。

初回実行におすすめのワークフロー

まず composio-skills/veriphone-automation/SKILL.md を読みます。この skill に含まれるサポートファイルはこれだけで、必要な MCP パターンが記載されています。エージェントのセッションでは、次の手順を依頼します。

1. 対象の Veriphone ユースケースについて RUBE_SEARCH_TOOLS を呼び出す。
2. 返された tool slug とスキーマを確認する。
3. Veriphone の接続ステータスを確認する。
4. 見つかったスキーマに一致するツールだけを実行する。
5. 結果を要約し、スキーマ上の前提やツールエラーがあれば含める。

この順序が重要なのは、この skill の主な価値が、古いツール呼び出しを防ぐ点にあるためです。

Workflow Automation 向けの実用的なプロンプトパターン

Workflow Automation で veriphone-automation を使う場合は、Veriphone 呼び出しだけでなく、その前後の処理も説明してください。例:

Validate new CRM lead phone numbers with Veriphone via Rube MCP. Input is a CSV-style list with lead_id, phone, and country_hint. Discover the current Veriphone tools first. Return JSON objects keyed by lead_id with normalized phone fields when available, validation result, and a next_action value of accept, review, or reject.

これにより、エージェントは Veriphone の結果を、実際の自動化判断に使える形へマッピングしやすくなります。

veriphone-automation skill FAQ

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

はい。AI クライアントがすでに MCP ツールに対応していれば使いやすい skill です。手順は短く実務的なので、初心者でもセットアップの流れに沿って利用できます。主な障壁はプロンプトの難しさではなく、Rube MCP が接続されているか、Veriphone toolkit の認証が有効になっているかです。

スクリプト、サンプル、ローカルコードは含まれていますか？

いいえ。リポジトリパスには SKILL.md のみが含まれます。このユースケースでは実行が Rube MCP ツール経由で行われるため、必ずしも弱点とは限りません。ただし、ローカルの補助スクリプト、テストフィクスチャ、独自の検証コードが skill に同梱されていると期待すべきではありません。

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

オフラインで電話番号検証を行いたい場合、独自の Veriphone SDK 連携が必要な場合、MCP server なしで実行できる決定的なコードが必要な場合には向いていません。また、電話番号データを接続済みの自動化ツール経由で送信することを組織が禁止している場合も避けてください。そのようなケースでは、バックエンドへの直接連携や社内の検証サービスのほうが適しています。

Composio のドキュメントを直接使う場合との違いは？

Composio の Veriphone toolkit ドキュメントは、プラットフォーム全体の機能範囲を理解するのに向いています。一方、veriphone-automation skill は、AI エージェントのセッション内で使う場合に有効です。ツールを探索し、接続を確認し、スキーマを検査し、実行して、結果を報告するという安全な順序を埋め込んでいるためです。長期運用する本番ワークフローを構築する場合は、両方を併用するとよいでしょう。

veriphone-automation skill を改善する方法

タスクの切り出しを明確にして veriphone-automation の結果を改善する

品質を最も高めるポイントは、Veriphone で照会したあとに必要なビジネス判断を明確にすることです。「電話番号検証」とだけ依頼するのではなく、出力によってリードを重複排除したいのか、不正なサインアップをブロックしたいのか、CRM レコードを補完したいのか、手動確認に回すレコードをフラグ付けしたいのかを伝えてください。そうすることで、エージェントはワークフローに合った出力フィールドとエラー処理を選びやすくなります。

よくある失敗を防ぐ

よくある問題には、Veriphone 認証が無効、ツール探索の省略、推測によるパラメータ指定、電話番号形式の曖昧さがあります。実行前に必ず RUBE_SEARCH_TOOLS を呼び出し、使用した正確なスキーマを報告するようエージェントに明示してください。可能であれば国情報のヒントや E.164 形式の電話番号を提供します。電話番号の解析品質は、国コンテキストに左右されることが多いためです。

初回出力後に反復する

初回実行後は、成功した照会と失敗した照会を分けて確認します。国番号の欠落、無効な形式、接続の無効化、利用できないフィールド、ツール実行エラーなど、原因別にエラーをグループ化するようエージェントに依頼してください。そのうえで、リスト全体を再処理するのではなく、修正した対象だけを再実行します。

リポジトリレベルで追加するとよい改善点

この skill は、短いサンプルプロンプト、サンプル出力契約、Rube 接続状態に関するトラブルシューティングセクションがあるとさらに使いやすくなります。fork を保守する場合は、単一番号の検証、バッチ補完、CRM 風の判断出力に関する例を追加するとよいでしょう。ただし、核となるルールは変えないでください。実行前に必ず現在の Veriphone ツールスキーマを探索する、という点です。