rafflys-automation

rafflys-automation skill の概要

rafflys-automation の用途

rafflys-automation は、Composio の Rube MCP server 経由で Rafflys の操作を実行するための Claude skill です。AI エージェントに現在の Rafflys tool schema を確認させ、Rafflys 接続を検証したうえで、汎用プロンプトよりも推測を減らしてタスク別ワークフローを実行したいユーザー向けに設計されています。

この skill の価値は、大きなローカルコードベースにあるわけではありません。中心は、エージェントに従わせる運用手順です。Rafflys の tool 名や input schema はハードコードされた前提ではなく、実行時点の MCP データとして扱うべきものなので、まず RUBE_SEARCH_TOOLS を使うよう指示します。

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

この rafflys-automation skill は、すでに Claude または MCP 対応クライアントを使っていて、Composio 経由で Rafflys の作業を自動化したい場合に適しています。代表的な用途は、利用可能な Rafflys actions をエージェントに調査させる、返された schema からワークフローを組み立てる、認証状態を確認する、必須フィールドを確認してから特定の Rafflys operation を実行する、といったものです。

古いドキュメントからコピーした壊れやすいプロンプト指示ではなく、tool discovery を先に行う実行フローを重視する Workflow Automation チームには特に有用です。

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

通常のプロンプトでは「Rafflys を使って」と指示するだけになりがちですが、その場合、tool 名を作り出したり、接続設定を見落としたり、古いパラメータを使ったりする可能性があります。rafflys-automation は、Rube MCP に接続し、Rafflys connection を管理し、現在の tools を検索し、返された schemas を確認してから、選択した tool を実行する、という再現性のある手順を追加します。この一連の流れが、導入する主な理由です。

導入前に確認すべき制約

この skill は Rube MCP と有効な Rafflys connection に依存します。補助スクリプト、ローカルリソース、追加の rules フォルダは同梱されておらず、中心となるファイルは SKILL.md です。環境で https://rube.app/mcp を MCP server として追加できない場合、または RUBE_MANAGE_CONNECTIONS 経由で Rafflys toolkit を認可できない場合、この skill はまだ役に立ちません。

rafflys-automation skill の使い方

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

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

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

次に、MCP 対応クライアントで Rube MCP を設定し、次を追加します。

https://rube.app/mcp

上流の skill では、MCP endpoint 自体に別途 API key は不要とされています。ただし、有効な Rafflys connection は必要です。Rafflys の作業を始める前に、RUBE_SEARCH_TOOLS が利用可能かをエージェントに確認させてください。

最初に確認するファイルと tools

まず composio-skills/rafflys-automation/SKILL.md を確認します。リポジトリのプレビュー上では、追加の scripts/、resources/、references/、rules/ ディレクトリはありません。そのため、重要な実装ガイダンスはこの 1 ファイルにまとまっています。

エージェントには次の順序で進めさせます。

1. 対象の Rafflys タスクに対して RUBE_SEARCH_TOOLS を呼び出す。
2. toolkit rafflys を指定して RUBE_MANAGE_CONNECTIONS を呼び出す。
3. connection が ACTIVE でない場合、返された認可フローを完了する。
4. 必要に応じて tool discovery を再実行し、最新の schema を使って実行する。

rafflys-automation を使うための強いプロンプト例

弱いプロンプト:

“Automate my Rafflys task.”

より強いプロンプト:

“Use the rafflys-automation skill. First confirm Rube MCP is available. Search Rafflys tools for this use case: [describe the exact Rafflys outcome]. Check the rafflys connection status and stop if it is not ACTIVE. Before executing, summarize the selected tool slug, required fields, optional fields, and any risky assumptions. Ask me for missing required values instead of guessing.”

この書き方が有効なのは、エージェントにタスクの目的、必須の discovery 手順、connection の境界条件、入力不足時の明確なルールをまとめて渡せるためです。

実務でのワークフローのコツ

期待する Rafflys object、action、filters、dates、campaign names、user identifiers、output format は具体的に伝えます。tool schema が、まだ渡していない required fields を返した場合は、エラーではなく確認ステップとして扱ってください。より安全に自動化するには、Rafflys データの作成、更新、削除につながる操作では、実行前に予定している call をエージェントに提示させるとよいでしょう。

繰り返し使うワークフローでは、必要に応じて同じ Rube session ID を維持し、tool discovery と実行コンテキストがつながった状態にします。

rafflys-automation skill FAQ

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

クライアントがすでに MCP tools に対応しているなら、初心者にも扱いやすい skill です。Rube MCP を追加し、RUBE_SEARCH_TOOLS を確認し、Rafflys connection を管理してから tools を発見する、という明確なセットアップ手順があります。ただし、RUBE_MANAGE_CONNECTIONS が返す Rafflys の認可フローを完了する部分では、初心者にはサポートが必要になる場合があります。

rafflys-automation を使うべきでないケースは？

オフライン自動化、ローカルのみで動くスクリプト、固定された Rafflys API wrapper が必要な場合は使わないでください。この skill は、Composio/Rube による実行時の tool discovery を前提にしています。また、組織として MCP server への接続やサードパーティのワークフロー tooling を許可していない場合にも向いていません。

直接 Rafflys API を使う場合との違いは？

versioned endpoints、tests、厳密な deployment controls が必要な本番コードでは、直接 API を使うほうが適している場合があります。rafflys-automation は、アシスタントが現在の schemas を確認し、Composio の Rafflys toolkit を通じて対話的にタスクを実行する、エージェント主導の運用に向いています。

Workflow Automation 向けの rafflys-automation にコーディングは必要ですか？

通常は不要です。この skill は prompt と tool を中心に動きます。MCP の設定と Rafflys toolkit の認可は必要ですが、日常的な利用では、ワークフローを明確に説明し、エージェントに適切な tools を発見して呼び出させることが主な作業になります。

rafflys-automation skill を改善する方法

rafflys-automation の入力を改善する

結果を改善する最短の方法は、あいまいな目的を運用上の具体情報に置き換えることです。Rafflys task type、target records、constraints、time range、success condition、そしてエージェントがすぐ実行してよいのか承認を求めるべきなのかを含めます。

例:

“Find Rafflys tools for exporting entries from campaign X between May 1 and May 31. Do not execute until you show me the required schema fields and confirm which fields are missing.”

よくある失敗を防ぐ

主な失敗パターンは、tool discovery の省略、inactive な connection、tool parameters に関する古い前提、required fields の不足です。これらはプロンプトで直接防ぎます。最初に RUBE_SEARCH_TOOLS を必須にし、connection check を要求し、値を作り出すのではなく質問するようエージェントに指示してください。

call が失敗した場合は、再試行する前に、試行した payload と最新の returned schema を比較するようエージェントに依頼します。

最初の出力後に反復する

最初の応答後は、スコープを絞って改善します。たとえば “only active campaigns,” “return a CSV-ready summary,” “exclude test records,” “dry-run the update plan first.” のように指定します。破壊的または影響の大きい操作では、schema discovery と execution の間に承認チェックポイントを追加してください。

リポジトリ側にあるとよい改善点

上流の skill は、Rafflys のユースケース例、サンプルの RUBE_SEARCH_TOOLS クエリ、create/update/delete actions 向けの安全な実行パターンが増えると、さらに実用性が高まります。それまでは SKILL.md を信頼できるガイドとして扱い、schema discovery、connection status、approval boundaries について自分のプロンプトで明確に指定してください。