piggy-automation

piggy-automation skill の概要

piggy-automation の用途

piggy-automation は、Composio の Rube MCP server を通じて Piggy タスクを自動化するための Claude skill です。Piggy API 呼び出しを決め打ちで実装するのではなく、実行時に現在の Piggy tool schema を検出し、ユーザーの Piggy 接続を確認したうえで、依頼されたワークフローを Rube 経由で実行するようエージェントに指示します。

Claude 互換の MCP client をすでに利用していて、毎回 Composio tool documentation を手作業で確認せずに、より安全で schema を意識した方法で Piggy 操作を実行したいユーザーに向いています。

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

piggy-automation skill は、より大きな AI ワークフローの中で Piggy 操作を繰り返し実行したいチームや運用担当者に適しています。特に、利用可能な tool や field が変わる可能性がある場合に有効です。次のようなことをエージェントに任せたいときに役立ちます。

• 現在利用できる Piggy tool を確認する;
• 操作前に Piggy 接続が有効か確認する;
• 自然文の依頼を Rube MCP の実行計画に落とし込む;
• input field や tool name に関する古い思い込みを避ける。

これは単体で使う Piggy client ではありません。Rube MCP と、認証済みの Piggy 接続に依存します。

主な差別化ポイント: まず tool を検索する

この skill で最も重要なのは、「必ず最初に検索する」という動作パターンです。エージェントは Piggy ワークフローを実行する前に、あなたの具体的なタスクを検索クエリとして RUBE_SEARCH_TOOLS を呼び出す必要があります。これにより、現在の tool slug、schema、推奨 plan、既知の注意点を取得できます。記憶に頼って推測させるより、はるかに信頼性があります。

導入前に知っておくべき制約

piggy-automation をインストールする前に、利用する client が MCP tools をサポートし、https://rube.app/mcp に接続できることを確認してください。また、toolkit piggy で RUBE_MANAGE_CONNECTIONS によって管理される有効な Piggy 接続も必要です。あなたの環境で MCP tools を Claude に公開できない場合、この skill 単体では役に立ちません。

piggy-automation skill の使い方

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

対応する skills 環境に skill をインストールします。例:

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

次に、client に以下の MCP server endpoint を追加して Rube MCP を設定します。

https://rube.app/mcp

インストール後は、まず composio-skills/piggy-automation/SKILL.md を開いてください。この repository はコンパクトな構成で、skill instructions は SKILL.md に集約されています。そのため、確認すべき個別の rules/、scripts/、resources/ フォルダはありません。

タスク実行前に必要な接続確認

piggy-automation をうまく使うには、tool と接続の検証から始めます。

1. RUBE_SEARCH_TOOLS が利用可能であることを確認する。
2. toolkit piggy を指定して RUBE_MANAGE_CONNECTIONS を使う。
3. Piggy が ACTIVE でない場合は、返された authorization link に従う。
4. ワークフローを実行する前に、接続ステータスを再確認する。
5. 実行したい具体的な Piggy タスクに対して RUBE_SEARCH_TOOLS を呼び出す。

この順序が重要です。検出を省略すると、エージェントが古い field name を使う可能性があります。接続確認を省略すると、plan を組み立てた後でワークフローが失敗することがあります。

ざっくりした目的を強いプロンプトに変える

弱いプロンプトの例は、「Use Piggy to do this task.」です。

piggy-automation skill 向けには、次のようなプロンプトのほうが有効です。

Use the piggy-automation skill. First call RUBE_SEARCH_TOOLS for the specific Piggy operation I describe, then check my Piggy connection with RUBE_MANAGE_CONNECTIONS. If the connection is active, propose the execution plan and required fields before running it. My task is: [describe the Piggy action, target object, filters, dates, account/store/customer context, and expected output].

実行したい action、対象 object、制約条件、返してほしい結果を含めてください。たとえば、summary がほしいのか、record の作成・更新をしたいのか、lookup なのか、実行前に confirmation が必要なのかを明記します。

信頼性を高める実践的なワークフロー

実データに影響するタスクでは、piggy-automation を 2 段階で使うのがおすすめです。

1. 検出と計画: エージェントに Piggy tools を検索させ、schema を確認し、required fields を特定し、提案する call を表示させる。
2. 実行: 必須 input と side effect が明確になってから、plan を承認する。

この流れは、update、creation、redemption、account 関連の操作のように、field や対象を間違えると望まない変更につながる処理で特に重要です。

piggy-automation skill FAQ

piggy-automation は Claude 専用ですか？

この skill は Claude 形式の skill 実行と MCP tool 利用を前提に書かれていますが、基盤となるワークフローは Rube MCP と Composio の Piggy toolkit に依存しています。別の agent 環境でも skill instructions を読み込み、同じ MCP tools を呼び出せるなら、このパターンを応用できます。最も簡単なのは、skills と MCP をサポートする Claude 互換 client を使う方法です。

通常のプロンプトより何が優れていますか？

通常のプロンプトでもモデルに「use Piggy」と依頼できますが、tool の検出、接続確認、schema チェックを必ず行わせるとは限りません。piggy-automation skill は、これらの手順を標準の運用手順として組み込んでいます。これにより推測が減り、エージェントが現在の Piggy toolkit を正しく使える可能性が高まります。

使う前に何を確認すべきですか？

Workflow Automation に piggy-automation を利用する前に、次を確認してください。

• RUBE_SEARCH_TOOLS があなたの client で応答すること;
• RUBE_MANAGE_CONNECTIONS で Piggy toolkit を一覧表示または管理できること;
• Piggy 接続ステータスが ACTIVE であること;
• 検索された tool schema が意図したタスクに合っていること;
• 操作が read-only なのか、データを変更するものなのかを理解していること。

piggy-automation を使うべきでない場面は？

静的なドキュメントだけが必要な場合、client が MCP servers に接続できない場合、または Piggy タスクに開発者の事前レビューが必要な custom business logic が含まれる場合は使わないでください。機密性の高い操作では、エージェントが検出した tool、必須 input、想定される side effect を示すまでは、直接実行を避けるべきです。

piggy-automation skill の改善方法

piggy-automation により良いタスク入力を与える

この skill は、意図だけでなく運用上の詳細をプロンプトに含めたときに最も力を発揮します。次の情報を提供してください。

• 実行したい正確な Piggy タスク;
• 関連する identifier、name、date、filter、account context;
• タスクが lookup、creation、update、deletion、reporting のどれか;
• 必要な output format;
• 実行前にエージェントが確認すべきかどうか。

これにより、RUBE_SEARCH_TOOLS がより関連性の高い tool match を返しやすくなり、エージェントが範囲の広すぎる操作を選ぶのを防げます。

よくある失敗パターンを防ぐ

最もよくある失敗は、schema 検出を省略し、想定上の tool fields に頼ってしまうことです。次に多いのは、Piggy 接続が active になる前に実行しようとすることです。3 つ目は、目的が曖昧すぎて tool search が汎用的になりすぎることです。

これを防ぐには、エージェントに対して、正確な use case を検索すること、接続ステータスを確認すること、required fields を列挙すること、execution tool を呼び出す前に不足値を尋ねることを明示してください。

最初の出力後に改善を重ねる

最初の tool search の後、急いで実行に進まず、ワークフローを調整してください。次のように確認します。

• 推奨される Piggy tool slug はどれで、その理由は何か？
• required fields と optional fields は何か？
• この call にはどのような side effect があるか？
• 実行前にどのような validation ができるか？
• 先に read-only lookup として実行できるか？

これにより、piggy-automation は単なる connector ではなく、より安全な workflow automation assistant として機能します。

チーム向けに skill instructions を改善する

社内版を管理している場合は、よく使う Piggy workflow、承認済みの naming convention、必須の review step、機密性の高い操作に対する「never execute without confirmation」ルールの例を追加してください。ただし、核となる要件は維持してください。つまり、常に最初に RUBE_SEARCH_TOOLS を呼び出し、この skill が古い思い込みではなく、最新の Composio Piggy schema に従い続けるようにすることです。