loyverse-automation

loyverse-automation skill の概要

loyverse-automation の機能

loyverse-automation は、Composio の Rube MCP server を通じて Loyverse の POS 業務を自動化するための Claude skill です。API フィールドを推測したり、古くなったスキーマをハードコードしたりするのではなく、まず RUBE_SEARCH_TOOLS で現在利用できる Loyverse tools を確認し、RUBE_MANAGE_CONNECTIONS で Loyverse connection を検証したうえで、適切な Rube tool calls を実行するようエージェントに指示します。

そのため loyverse-automation skill は、AI エージェントに Loyverse の運用タスクを手伝わせつつ、Composio の最新 tool schema に沿って安全に進めたい場合に特に役立ちます。

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

loyverse-automation は、Loyverse data を扱っていて、Composio Loyverse toolkit で公開されている store、item、inventory、receipt、customer、employee、POS 関連のワークフローについて、Claude にアクションの実行や計画作成を任せたい場合に適しています。店舗運営者、automation builders、no-code/low-code チーム、MCP 対応 AI クライアントをすでに使っている開発者に向いています。

この skill の本質的な用途は「Loyverse API コードを書くこと」ではありません。「特定の Loyverse 業務タスクに対して、現在利用できる Rube MCP tools を安全かつ正確に使うこと」です。

導入時の必須条件

重要な依存関係は Rube MCP です。利用するクライアントで MCP server https://rube.app/mcp が設定されており、RUBE_SEARCH_TOOLS が利用可能で、さらに RUBE_MANAGE_CONNECTIONS を通じて toolkit loyverse の Loyverse connection が有効になっている必要があります。

AI クライアントで MCP tools を使えない場合や、完全にオフラインの自動化が必要な場合、この skill は適していません。

loyverse-automation skill の使い方

loyverse-automation のインストールとセットアップ

次のコマンドで、リポジトリから skill をインストールします。

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

次に、クライアントに以下を追加して Rube MCP を設定します。

https://rube.app/mcp

Loyverse に関するアクションを依頼する前に、次を確認してください。

1. クライアント上で RUBE_SEARCH_TOOLS が応答する。
2. RUBE_MANAGE_CONNECTIONS で toolkit loyverse を確認できる。
3. Loyverse connection status が ACTIVE である。
4. 有効でない場合は、返された authorization link に従って認可し、status を再確認する。

この skill の repo path には SKILL.md しかないため、まずそのファイルを読んでください。付属の scripts、examples、reference folders はありません。実行時に Rube tool discovery を行うステップが、信頼すべき情報源です。

skill を効果的に指示するプロンプト

弱いプロンプトの例です。

Automate Loyverse inventory.

loyverse-automation を使う場合は、次のように具体化すると効果的です。

Use the loyverse-automation skill. First search Rube tools for current Loyverse inventory-related schemas. Check that the Loyverse connection is active. Then identify the safest tool plan to update stock for item SKU ABC-123 at store Downtown to quantity 25. Show the tool slug, required fields, assumptions, and ask before executing any write operation.

このほうがうまくいくのは、対象となる業務オブジェクト、識別子、実行したいアクション、店舗などの文脈、安全要件、実行してよい範囲が含まれているためです。

読み取り専用のタスクであれば、その点を明確に伝えます。

Use loyverse-automation to retrieve recent Loyverse receipts for the last 7 days. Discover tools first, use the active Loyverse connection, and return a table with receipt number, date, total, payment type, and customer if available.

推奨されるワークフローパターン

信頼性の高い loyverse-automation の進め方は、次の順序です。

1. 汎用的な検索ではなく、具体的なユースケースに合わせて RUBE_SEARCH_TOOLS で tools を発見する。
2. Rube が返した schemas を確認する。特に required fields、identifiers、date formats、pagination を確認する。
3. toolkit loyverse について RUBE_MANAGE_CONNECTIONS で connection を確認する。
4. create、update、delete、bulk changes では特に、実行前に計画を立てる。
5. 入力が発見済み schema と一致している場合にのみ、選択した tool を実行する。
6. 返された IDs、status fields、errors、または follow-up read operations によって 結果を検証する。

この手順が重要なのは、Loyverse と Composio の tool schemas が変わる可能性があるためです。この skill の主な差別化ポイントは、実行前の discovery を必須にしていることです。

出力品質を上げる実践的なコツ

エージェントには、運用上の制約を最初に伝えてください。書き込みを実行してよいか、承認が必要か、該当レコードが見つからない場合にどう扱うか、どの store や terminal の文脈が重要か、部分的な失敗をどう報告するか、といった点です。

一括処理では、まず小さなサンプルを渡してください。全件実行の前に、自分の列を発見済み Rube schema にどう対応させるかをエージェントに確認させます。たとえば item updates の CSV を渡す場合は、sku、item_name、variant、store、quantity を RUBE_SEARCH_TOOLS が返したフィールドへどうマッピングするか、dry-run で確認させます。

loyverse-automation skill の FAQ

loyverse-automation は開発者向けだけですか？

いいえ。MCP client と Loyverse connection がすでに設定されていれば、開発者でなくても利用できます。ただし、Rube MCP のセットアップと Loyverse authorization flow の承認は、誰かが完了しておく必要があります。初心者は、更新系の操作を試す前に、まず読み取り専用の取得タスクから始めるのが安全です。

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

通常のプロンプトでは、API フィールドを作り上げてしまったり、古い前提に基づいて動いてしまったりする可能性があります。loyverse-automation skill は、実行前に Rube MCP を通じた live tool discovery を明示的に求めます。これにより、エージェントは現在の tool slugs、schemas、execution plans、注意点を把握でき、推測や tool call の失敗を減らせます。

この skill を使うべきでないケースは？

MCP を使わずに Loyverse API コードを直接生成したい場合、AI クライアントが Rube tools を呼び出せない場合、または組織が POS data への AI 支援アクセスを禁止している場合は使わないでください。また、計画をレビューできない、小さなサンプルでテストできない、実行後に結果を検証できない状況では、リスクの高い bulk updates への利用も避けるべきです。

Workflow Automation 向けの loyverse-automation で何ができますか？

Workflow Automation では、自然言語の業務リクエストを tool-driven な手順に変換できます。具体的には、Loyverse tools の発見、connection の認証確認、選択した operation の実行、結果の要約までをつなげます。静的な API examples よりも、現在の schemas と connection state が重要になる agentic workflows に特に向いています。

loyverse-automation skill を改善する方法

完全な文脈で loyverse-automation のプロンプトを改善する

品質を最も大きく改善できるのは、タスクの前提を適切に伝えることです。次の情報を含めてください。

• 対象オブジェクト: item、receipt、customer、store、employee、inventory、modifier、payment data
• アクション: retrieve、create、update、sync、compare、export、validate
• 識別子: SKU、item ID、receipt number、customer email、store name、date range
• 権限: read-only、draft plan first、execute after confirmation
• 出力形式: table、JSON、checklist、exception report、summary

これにより、エージェントは精度の高い RUBE_SEARCH_TOOLS query を選びやすくなり、広すぎて情報量の少ない discovery を避けられます。

よくある失敗パターンに注意する

よくある問題には、Loyverse connection が inactive であること、store や item の identifiers が不足していること、date ranges が曖昧なこと、dry runs なしで bulk updates を行うこと、schema discovery 前に field names を決め打ちしてしまうことがあります。もう一つの失敗パターンは、書き込み操作を実行してよいかどうかを指定せずに、エージェントへ「とにかくやって」と頼むことです。

より安全な結果を得るには、実行前に発見された tool slug と required fields をエージェントに表示させてください。

初回出力のあとに改善を重ねる

初回実行後は、次のように確認してワークフローを改善します。

• 不足していた required fields は何か？
• 確信を持って照合できなかった records はどれか？
• 結果は paginated または truncated されていなかったか？
• 変更を確認するには、どの validation call を使うべきか？
• このプロセスを再利用可能な checklist に変換できるか？

これにより、単発の Loyverse タスクを、繰り返し使える automation pattern にできます。

skill を責任ある形で拡張する

skill をカスタマイズする場合は、よく使う Loyverse operations の例を追加してください。たとえば inventory adjustment、receipt export、customer lookup、item synchronization などです。RUBE_SEARCH_TOOLS を最初に呼び出すという指示は残してください。これを削除すると、この skill の安全性と正確性に関する最大の強みが弱まります。bulk writes、financial data、customer information については、組織固有の approval rules も追加してください。