SKILLKnowledge Workproductivity

awx-best-practices

プラグイン: Airwallex
ソース: GitHub で見る ↗

説明

Airwallex フォールバックスキル（専用スキルがない場合の補助機能）— Airwallex CLI（コマンドラインツール）または Airwallex MCP サーバーと連携します。 **次のような場合に使用:** 専用のワークフロースキル（作業用スキル）が該当する機能を持たないときのみ使用します。 **対応内容:** - 一時的な操作（リスト表示、取得、更新、削除、無効化、キャンセル） - Airwallex API（プログラミングインターフェース）全般に関する質問 - トラブルシューティング（問題解決） - ワークフロースキルでカバーされていない機能（支払いリンク、払い戻し、紛争解決、支出管理、財務レポート） **重要な注意:** このスキルとワークフロースキルを同時に読み込まないでください。各ワークフロースキルは独立して完結しているためです。 **他のスキルを使用すべき場合:** - 請求書・課金・クーポン・メーター・クレジットノート → contract-to-billing スキル - 仕入先・受取人 → beneficiary-creation スキル - カード → card-provisioning スキル - 残高・為替・キャッシュフロー → manage-cashflow スキル

原文を表示

Fallback Airwallex skill — works with the Airwallex CLI or the Airwallex MCP server. Use ONLY when no dedicated workflow skill matches the task. Covers ad-hoc operations (list, get, update, delete, void, cancel), general Airwallex API questions, troubleshooting, and domains not covered by a workflow skill (payment links, refunds, disputes, spend management, financial reports). Do NOT load this skill alongside a workflow skill — each workflow skill is self-contained. For invoices/billing/coupons/meters/credit notes use contract-to-billing, for suppliers/beneficiaries use beneficiary-creation, for cards use card-provisioning, for balances/FX/cashflow use manage-cashflow.

ユースケース

専用スキルにない機能を補助する
Airwallex APIについて質問するとき
支払いリンク・払い戻しを操作するとき
紛争解決・支出管理・財務レポートが必要なとき
トラブルシューティングで問題を解決するとき

本文（日本語訳）

Airwallex ベストプラクティス

Airwallex（企業向け国際決済プラットフォーム）の専用ワークフロースキルが該当しない場合の補助的なスキルです。専用のワークフロースキルが当てはまる場合は、このスキルのみを使用してください。 各ワークフロースキル（beneficiary-creation、card-provisioning、contract-to-billing、manage-cashflow）は独立した設計になっており、このスキルと一緒に読み込まないでください。

使用時機

次のような場合に使用:

一度限りの操作（データの表示、取得、更新、削除、無効化、キャンセル、無効化）
Airwallex APIの一般的な質問やトラブルシューティング
支払いリンク、返金、紛争対応、支出管理、財務報告など、専用のワークフロースキルでカバーされていない領域

代わりに専用スキルを使用してください

タスク	スキル
発注書・契約書・見積もりから請求書を作成	contract-to-billing
クーポン、使用量の追跡、クレジット申請	contract-to-billing
サプライヤーのオンボーディング（利用開始手引き）・受取人の作成	beneficiary-creation
法人カードの発行	card-provisioning
資金ポジション、外国為替（為替交換）、残高、再配分	manage-cashflow

専用スキルが適合する場合はそちらを使用してください。このスキルと併用しないでください。

対応外 — 拒否とリダイレクト

API呼び出しを組み合わせて対応を試みないでください。該当機能は利用できないことを明確に述べ、最も近い代替案を説明し、その代替案での支援を提供してください。

リクエストパターン	対応外の理由	リダイレクト先
「予測」「ヘッジ戦略」「為替予測」	参考情報としての現在レートのみ提供可能	manage-cashflow で現在のエクスポージャーと参考情報としての為替レートを提供
「利回り」「投資アドバイス」「遊休資金」「自動補充」「レートをロックすべき?」	財務アドバイスまたは対応していない資金管理操作	manage-cashflow で現在の残高、債務、参考情報としての為替レートのみを提供

環境クイックスタート

完全な詳細（認証、機能の発見、書き込み時の安全措置、ページング、エラー処理）は references/surface-quickstart.md を参照してください。

運用ルール

不足している情報を絶対に作り上げたり推測したりしないでください。 必須項目が不確かな場合は、ユーザーに確認してください。
常に最新データを取得してください — 毎回のステップの前に再取得してください。
ユーザーがファイルまたは添付ファイルを提供した場合は、それを基本事実として扱ってください 。ただし、ユーザーが最新データを求めた場合を除きます。
意図が曖昧なリクエストについては、開始する前に確認してください。
対応していない機能を過度に主張しないでください。 送金、出金、為替実行、カード番号/セキュリティコード取得は即座に拒否し、何が利用できないかを述べて、最も近い代替案を提供してください。
財務アドバイスは提供しないでください。 利回り、投資商品、自動補充、ヘッジ戦略、為替予測、レートロックを決して推奨しないでください。資金管理に関する質問については manage-cashflow にリダイレクトし、為替に関する議論は参考情報として明確にラベル付けしてください。
対応する質問と対応しない質問を分けてください。 対応する部分は完了し、設定されていない部分を明確に述べてください。
ユーザー向けの出力では、生のIDより事業上のラベルを優先してください。 可能な限り、生のシステムIDではなく、人間が読める事業上のラベル（顧客名、商品名、受取人名、カード愛称など）を表示してください。IDは後続のアクション、検証、トラブルシューティング、またはユーザーが明示的に求めた場合にのみ表示してください。

Airwallexの基本概念

1つの資金口座、複数通貨。 「AUD残高」と述べてください。「AUD資金口座」ではなく。
請求書＝売上債権（入金）。 ユーザーが顧客に対して発行するもの。
掛け金＝買上債務（出金）。 ユーザーがサプライヤーに負う金額。
為替変換は1つの資金口座内で発生 — 資金口座間ではありません。

重大な操作

これらは取り消し不可能または大きな影響があります。これらのいずれかを実行する前に: (1) 環境（サンドボックス vs 本番環境）を確認して述べる、(2) 影響を説明する、(3) ユーザーから明確な同意を得てください。

操作	CLI	MCP	備考
請求書を無効化	`airwallex --confirm invoices void <id>`	billing-invoice無効化ツールを実行	取り消し不可能。「確定・未払い」状態のみ対象。
下書き請求書を削除	`airwallex --confirm invoices delete <id>`	非公開	「下書き」状態のみ対象。
請求書を確定	`airwallex --confirm invoices finalize <id>`	billing-invoice確定ツールを実行	取り消し不可能 — 確定後は編集不可。
請求書を支払い済みにマーク	`airwallex --confirm invoices mark-as-paid <id>`	billing-invoice支払い済みマークツールを実行	「確定」状態である必要があります。Airwallex外での支払いの場合に使用。
定期請求をキャンセル	`airwallex --confirm subscriptions cancel <id>`	定期請求キャンセルツールを実行	スキーマでフラグを確認してください。
カードを無効化	`cards update <id>` body `{"status":"INACTIVE"}`	card-updateツール（`card_status: INACTIVE`）	取り消し可能。references/api_traps.md でここで設定できない状態を確認してください。
カードを閉鎖	`cards update <id>` body `{"status":"CLOSED"}`	card-updateツール（`card_status: CLOSED`）	永続的。
為替変換	Airwallex ダッシュボードのみ	Airwallex ダッシュボードのみ	どちらの方法でも実行できません。
クレジット申請を確定	`airwallex --confirm credit-notes finalize <id>`	クレジット申請ツールは非公開 — CLI またはAirwallex ダッシュボードを使用	取り消し不可能。
クレジット申請を無効化	`airwallex --confirm credit-notes void <id>`	クレジット申請ツールは非公開 — CLI またはAirwallex ダッシュボードを使用	取り消し不可能。
グローバル口座を閉鎖	`airwallex --confirm global-accounts close <id>`	グローバル口座閉鎖ツールを実行（公開されている場合）	永続的。
カード所有者を削除	`airwallex --confirm cardholders delete <id>`	カード所有者削除ツールを実行（公開されている場合）	アクティブなカードがないことを確認してください。

エラー処理

状況	対応
必須項目が不足または曖昧	停止して、不足項目をリストアップし、ユーザーに確認
APIエラー	完全なエラーを表示し、ユーザーに確認
API検証エラー	references/api_traps.md を確認。CLIを使用している場合は、 `airwallex <resource> <action> --api-schema-only` を実行してボディ構造を確認。そうでなく MCPサーバーを使用している場合は、ツールの入力スキーマを再確認。
401（認証エラー） / 認証期限切れ	CLIを使用している場合は、 1回再試行（自動更新）。再試行に失敗した場合、ユーザーに環境を確認して、すぐに `auth login`（または `--prod`）を自分で実行し、`auth whoami` で確認して再開。そうでなく MCPサーバーを使用している場合は、サーバーは自動的にトークンをリフレッシュします。ツールが 401 を返し続ける場合、OAuth認可が取り消されています — ユーザーに MCPサーバーの再認可を求めてください。
重複検出	詳細を表示し、ユーザーに選択させる
部分的な完了	成功したもの（ID付き）と失敗したものをレポート

リファレンス

references/api_traps.md — スキーマ/マニフェストに表示されない非自明なボディ制約。
CLIを使用している場合は、 airwallex --tree --compact [group] でコマンド検出、airwallex <resource> <action> --api-schema-only でコマンドスキーマ（必須フラグ含む）を確認。
Airwallex API イントロダクション

フィードバック

ユーザーがこのスキルの性能について反応した場合（賞賛、不満、ギャップ、不足機能）、または使用中に実際のギャップ、不明確/誤った指示、予期しない動作に遭遇した場合 — フィードバックを転送することを簡潔に提供し、ユーザーが同意したら送信してください。提供時機、チャネルコマンド（CLI / MCP）、ルール（事前確認、機密データなし、頻繁に催促しない）については references/feedback.md を参照してください。

原文（English）を表示

Airwallex Best Practices

Fallback skill for Airwallex tasks. Use only when no dedicated workflow skill fits. Each workflow skill (beneficiary-creation, card-provisioning, contract-to-billing, manage-cashflow) is self-contained — do NOT load this skill alongside them.

When to use

Ad-hoc operations (list, get, update, delete, void, cancel, deactivate)
General Airwallex API questions or troubleshooting
Payment links, refunds, disputes, spend management, financial reports, and other domains not covered by a dedicated workflow skill

Use a workflow skill instead

Task	Skill
Create invoice from PO/contract/quote	contract-to-billing
Coupons, meters, usage events, credit notes	contract-to-billing
Onboard suppliers / create beneficiaries	beneficiary-creation
Provision corporate cards	card-provisioning
Cash position, FX, balances, rebalancing	manage-cashflow

If a workflow skill matches, use that skill instead — do NOT load this one alongside it.

Out of scope — refuse and redirect

Do NOT attempt to fulfill these by aggregating API calls. State plainly that the capability is not available, explain the closest alternative, and offer to help with it.

Request pattern	Why out of scope	Redirect
"Forecast", "hedging strategy", "FX prediction"	Agent provides indicative spot rates only	Offer manage-cashflow for current exposure and indicative FX rates
"Yield", "investment advice", "idle funds", "automated top-up", "should I lock a rate?"	Financial advice or unsupported treasury action	Offer manage-cashflow for current balances, obligations, and informational indicative FX only

Environment quickstart

See references/surface-quickstart.md for full per-surface details (auth, discovery, write safety, pagination, error handling).

Operational rules

NEVER fabricate or assume missing information. If any required field is uncertain — STOP and ask the user.
Always fetch fresh data — re-fetch before every step.
If the user supplied a file or attachment, treat it as primary ground truth unless they ask for live data.
For ambiguous-intent requests, confirm the action before starting.
Never overclaim unsupported capabilities. Transfers, payouts, FX execution, PAN/CVV retrieval: refuse immediately, state what is not available, offer the closest alternative.
Do not provide financial advice. Never recommend yield, investment products, automated top-ups, hedging strategy, FX prediction, or rate-locking. For treasury questions, redirect to manage-cashflow and keep any FX discussion informational and clearly labelled as indicative.
Split supported and unsupported asks. Complete the supported portion and clearly state what was not configured.
Prefer business labels over raw IDs in user-facing output. Show human-readable business labels (customer names, product names, beneficiary names, card nicknames, etc.) instead of raw system IDs whenever possible. Only show IDs when they are operationally necessary for follow-up actions, verification, troubleshooting, or when the user explicitly asks for them.

Core Airwallex concepts

One wallet, multiple currencies. Say "AUD balance" — never "AUD wallet."
Invoices = receivables (money in). Issued BY the user TO their customers.
Bills = payables (money out). Money the user owes to suppliers.
FX conversions happen within one wallet — not between wallets.

Consequential operations

These are irreversible or high-impact. Before executing ANY of them: (1) confirm and state the environment (sandbox vs production), (2) explain the effect, (3) get explicit user confirmation.

Operation	CLI	MCP	Notes
Void invoice	`airwallex --confirm invoices void <id>`	invoke the billing-invoice void tool	Irreversible. FINALIZED+UNPAID only.
Delete draft invoice	`airwallex --confirm invoices delete <id>`	not exposed	DRAFT only.
Finalize invoice	`airwallex --confirm invoices finalize <id>`	invoke the billing-invoice finalize tool	Irreversible — cannot edit after.
Mark invoice paid	`airwallex --confirm invoices mark-as-paid <id>`	invoke the billing-invoice mark-as-paid tool	Must be FINALIZED. Use when paid outside Airwallex.
Cancel subscription	`airwallex --confirm subscriptions cancel <id>`	invoke the subscription cancel tool	Check flags via schema.
Deactivate card	`cards update <id>` body `{"status":"INACTIVE"}`	card-update tool with `card_status: INACTIVE`	Reversible. See references/api_traps.md for which statuses are NOT settable here.
Close card	`cards update <id>` body `{"status":"CLOSED"}`	card-update tool with `card_status: CLOSED`	Permanent.
FX conversion	Airwallex Dashboard only	Airwallex Dashboard only	Not executable via either surface.
Finalize credit note	`airwallex --confirm credit-notes finalize <id>`	credit-note tools not exposed — use the CLI or the Airwallex Dashboard	Irreversible.
Void credit note	`airwallex --confirm credit-notes void <id>`	credit-note tools not exposed — use the CLI or the Airwallex Dashboard	Irreversible.
Close global account	`airwallex --confirm global-accounts close <id>`	invoke the global-account close tool if exposed	Permanent.
Delete cardholder	`airwallex --confirm cardholders delete <id>`	invoke the cardholder delete tool if exposed	Ensure no active cards.

Error handling

Situation	Action
Required field missing or ambiguous	STOP, list gaps, ask user
API error	Show full error, ask user
API validation error	Check references/api_traps.md. IF using the CLI, THEN also run `airwallex <resource> <action> --api-schema-only` to verify body structure. ELSE IF using the MCP server, THEN re-inspect the tool's input schema.
401 / auth expired	IF using the CLI, THEN retry once (auto-refresh). If retry fails, ask the user which environment, immediately execute `auth login` (or `--prod`) yourself, confirm with `auth whoami`, then resume. ELSE IF using the MCP server, THEN the server refreshes tokens automatically; if a tool keeps returning 401, the OAuth grant has been revoked — ask the user to re-authorize the MCP server.
Duplicate detected	Show details, let user choose
Partial completion	Report what succeeded (with IDs) and what failed

References

references/api_traps.md — non-obvious body constraints beyond what the schema/manifest surfaces.
IF using the CLI, THEN airwallex --tree --compact [group] for command discovery and airwallex <resource> <action> --api-schema-only for command schemas (including required flags).
Airwallex API Introduction

Feedback

When the user reacts to how this skill performed (praise, frustration, a gap, a missing capability) — or when you hit a real gap, unclear/wrong instruction, or unexpected behavior while using it — briefly offer to pass feedback along and, on the user's go-ahead, submit it. See references/feedback.md for when to offer, the channel commands (CLI / MCP), and the rules (ask first, no sensitive data, don't nag).

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。