passslot-automation

passslot-automation skill の概要

passslot-automation でできること

passslot-automation は、Composio の Rube MCP server 経由で Passslot ワークフローを自動化するための Claude skill です。単体で使う Passslot SDK ラッパーではありません。AI エージェントに対して、RUBE_SEARCH_TOOLS で現在の Passslot tool schema を確認し、RUBE_MANAGE_CONNECTIONS で有効な Passslot 接続を検証したうえで、Rube 経由の適切な Composio Passslot action を実行するよう案内します。

向いているユーザーと用途

この passslot-automation skill は、すでに Claude または MCP 対応クライアントを使っていて、すべての API フィールドを手作業で対応付けることなく Passslot 操作を自動化したいチームに向いています。Passslot 関連オブジェクトの作成・更新、利用可能な Passslot action の確認、ビジネス上の依頼を tool-safe な実行計画に落とし込む作業に適しています。主な価値は、勘に頼る部分を減らすことです。古い前提に依存せず、まず live schema を確認するようエージェントに指示します。

導入に必要な条件

重要な依存関係は Rube MCP です。利用するクライアントで https://rube.app/mcp を MCP server として設定し、RUBE_SEARCH_TOOLS が使える状態になっている必要があります。さらに、toolkit passslot を使って RUBE_MANAGE_CONNECTIONS から Rube 上の有効な Passslot 接続を用意する必要があります。接続が ACTIVE でない場合は、返された認証リンクで認証を完了するまでワークフローを停止します。

passslot-automation skill の使い方

passslot-automation のインストールとセットアップ手順

環境が GitHub からの skill インストールに対応している場合は、ComposioHQ/awesome-claude-skills から skill path composio-skills/passslot-automation を指定してインストールします。一般的なインストーラーの例は次のとおりです。

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

次に、AI クライアントで Rube MCP を設定し、https://rube.app/mcp を MCP server として追加します。インストール後は、まず skill の SKILL.md を開いてください。このリポジトリには追加の README.md、scripts/、resources/、rules/ フォルダは含まれていないため、主要な運用ガイドはこのファイルに集約されています。

skill に渡すべき入力

passslot-automation を安定して使うには、具体的な Passslot の目的、対象となるオブジェクトまたはレコード、既知の識別子、期待する結果をエージェントに伝えます。「Passslot の作業をやって」のような依頼だけでは不十分です。より良いプロンプトは次のようになります。

“Use the passslot-automation skill. First search Rube tools for the current Passslot schema. Then check that the passslot connection is active. I need to update the Passslot item for campaign X so that field Y becomes Z. If the required identifier is missing, ask me before executing.”

この形が有効なのは、対象システム、安全な実行順序、既知のデータ、そしてどの時点で停止すべきかをエージェントに明示できるためです。

推奨される実行ワークフロー

passslot-automation のガイドとしては、毎回次の順序で進めるのが望ましいです。

1. 汎用的な検索ではなく、具体的な Passslot タスクに合った use case で RUBE_SEARCH_TOOLS を呼び出す。
2. 返された tool slug、必須フィールド、schema、実行計画、注意点を確認する。
3. toolkit passslot に対して RUBE_MANAGE_CONNECTIONS を呼び出す。
4. 接続が ACTIVE の場合にのみ続行する。
5. 確認済みの schema に合うフィールドで、選択した Passslot tool を実行する。
6. 変更内容、使用した識別子、スキップした手順や不確実だった点を報告する。

重要なのは、schema の確認は任意ではないという点です。Rube tool schema は変わる可能性があり、この skill は実行前に live discovery を行う前提で設計されています。

実用的なプロンプト例

発見、検証、実行を分けて指示するプロンプトを使います。例:

“Find the current Passslot tools for creating a pass, summarize the required fields, and ask me for any missing required values before creating anything.”

または:

“Search Passslot tools for operations related to customer pass updates. Do not execute until you show me the selected tool name, required inputs, and the active connection status.”

こうしたプロンプトにより、エージェントがパラメータを勝手に作ったり、認可状態を確認する前に実行してしまったりする典型的な失敗を防げます。

passslot-automation skill FAQ

passslot-automation は Rube MCP なしで使えますか？

いいえ。passslot-automation skill は Rube MCP tools、特に RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS に依存しています。クライアントに Rube が設定されていない場合、この skill はワークフロー手順を文章で示すだけのものになり、Passslot 操作は実行できません。

通常の Passslot プロンプトと何が違いますか？

通常のプロンプトでは、モデルが記憶に基づいて Passslot API フィールドを推測してしまう可能性があります。passslot-automation skill は、まず現在の Composio/Rube tool schema を検索し、次に Passslot 接続を検証し、その後に実行するようエージェントへ明示的に指示します。想定上のエンドポイントではなく live tool metadata に基づいて動くため、ワークフロー自動化においてより安全です。

初心者にも向いていますか？

はい。ただし、MCP server の接続と認証フローの完了に抵抗がないことが前提です。初心者は、まず読み取り専用または discovery 中心の依頼から始めるのがよいでしょう。たとえば “Search available Passslot tools and explain what each one needs.” のような依頼です。返された schema と接続状態を理解するまでは、一括変更から始めないでください。

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

Passslot API を直接コーディングしたい場合、オフラインのドキュメントが必要な場合、または Composio Rube エコシステム外のワークフローには向いていません。また、明示的なレビューゲート、dry-run の要約、人による実行前確認を追加しない限り、リスクの高い一括更新にも不向きです。

passslot-automation skill を改善する方法

より強い文脈で passslot-automation の結果を改善する

passslot-automation の出力を改善する最短の方法は、ビジネス上の目的と運用上の制約をセットで伝えることです。既知の ID、正確なフィールド名、対象レコード、許可する操作、エージェントが実行まで行ってよいのか、計画作成だけに留めるべきなのかを含めます。たとえば “Only search and validate; do not create or update records” と “complete the update” では、実行上の意味が大きく異なります。

防ぐべきよくある失敗

主なリスクは、tool discovery の省略、Passslot 認証が inactive のまま進むこと、必須フィールドの不足、実行範囲が広すぎることです。“always call RUBE_SEARCH_TOOLS first”、“stop if the Passslot connection is not active”、“ask before using guessed identifiers” のような指示を追加してください。これらの制約は skill の設計と合っており、意図しない変更を減らせます。

最初の出力後にどう反復するか

初回実行後は、選択された tool slug、必須 schema フィールド、指定済みの値、不足している値、予定されている実行順序を確認します。曖昧な点があれば、タスクを絞り込み、より具体的な use case で discovery をやり直します。繰り返し使うワークフローでは、Passslot のオブジェクトタイプ、承認ルール、レポート形式を含むプロンプトテンプレートを保存しておくと便利です。

メンテナーが次に追加できるもの

このリポジトリは、よくある Passslot 操作向けのサンプルプロンプト、inactive な接続に関する短いトラブルシューティング、create、update、list、verify ワークフロー向けの安全な実行パターン例があると、より導入しやすくなります。現在の skill は SKILL.md に集約されているため、こうした追加があると、ユーザーはインストール後に Workflow Automation 向けの信頼できる passslot-automation へより早く移行できます。