SKILLOfficialproductivity

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 の一般的な質問やトラブルシューティング
支払いリンク、払戻、紛争、支出管理、財務報告、および専用ワークフロースキルでカバーされていないその他の領域

代わりにワークフロースキルを使用する

タスク	スキル
PO/契約/見積から請求書を作成	contract-to-billing
クーポン、メーター、使用イベント、クレジットメモ	contract-to-billing
サプライヤーのオンボーディング（利用開始手続き）/ 受取人を作成	beneficiary-creation
法人カードをプロビジョニング（設定・配置）	card-provisioning
キャッシュポジション（現金保有状況）、為替、残高、残高調整	manage-cashflow

ワークフロースキルが当てはまる場合は、そのスキルを使用してください。本スキルとは一緒に読み込まないでください。

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

API 呼び出しを組み合わせてこれらを実行しないでください。その機能は利用できないことを明確に述べ、最も近い代替案を説明し、それでのサポートを提案してください。

リクエストの種類	対応外の理由	リダイレクト先
「予測」「ヘッジ戦略」「為替予測」	エージェントが提供できるのは参考値のスポットレート（現物為替レート）のみ	manage-cashflow で現在の為替エクスポージャーと参考値の為替レートを提案
「利回り」「投資助言」「余裕資金」「自動チャージ」「レートをロックすべき？」	財務助言または非対応の資金管理操作	manage-cashflow で現在の残高、支払い義務、および情報提供目的の参考値為替レートのみを提案

環境クイックスタート

表面別の詳細（認証、機能検出、書き込み安全性、ページネーション（分割表示）、エラー処理）については、references/surface-quickstart.md をご参照ください。

運用ルール

不足している情報を作成したり仮定したりしないでください。 必須項目が不確実な場合は、立ち止まってユーザーに確認してください。
常に最新データを取得してください — 各ステップの前に再取得してください。
ユーザーがファイルまたは添付ファイルを提供した場合、ライブデータを求める指示がない限り、それを信頼できる情報源として扱ってください。
意図が曖昧なリクエストの場合は、開始前にアクションを確認してください。
非対応の機能を過剰に述べないでください。 送金、払出、為替実行、PAN/CVV 取得：即座に拒否し、何が利用できないかを述べ、最も近い代替案を提案してください。
財務助言を提供しないでください。 利回り、投資商品、自動チャージ、ヘッジ戦略、為替予測、レートロック（固定化）は決して勧めないでください。資金管理に関する質問は manage-cashflow にリダイレクトし、為替の説明は情報提供目的に限定し、「参考値」であることを明確に表示してください。
対応可能な部分と非対応の部分を分けてください。 対応可能な部分を完了し、設定されなかった部分を明確に述べてください。
生の ID ではなくビジネスラベルを優先的に表示してください。 ユーザー向けの出力では、生の ID ではなく人間が読める顧客名、商品名、受取人名、カードのニックネームなどのビジネスラベルを表示してください。ID は運用上、後続のアクション、検証、トラブルシューティングのために必要な場合、またはユーザーが明示的に求めた場合にのみ表示してください。

Airwallex の主要概念

1 つのウォレット、複数の通貨。 「AUD 残高」と言ってください。「AUD ウォレット」ではなく。
請求書 = 売掛金（収入）。 ユーザーが顧客に向けて発行。
請求書（仕入請求書）= 買掛金（支出）。 ユーザーがサプライヤーに支払う金額。
為替変換は 1 つのウォレット内で実行 — ウォレット間ではない。

重大な操作

これらは取り消し不可または高リスクな操作です。これらのいずれかを実行する前に：(1) 環境（サンドボックス vs 本番環境）を確認して述べる、(2) 効果を説明する、(3) ユーザーの明示的な確認を得る。

操作	CLI	MCP	注記
請求書を無効化	`airwallex --confirm invoices void <id>`	billing-invoice void ツールを実行	取り消し不可。ファイナライズ＋未払いのみ。
ドラフト請求書を削除	`airwallex --confirm invoices delete <id>`	非公開	ドラフトのみ。
請求書をファイナライズ（確定）	`airwallex --confirm invoices finalize <id>`	billing-invoice finalize ツールを実行	取り消し不可 — その後編集不可。
請求書を支払済みにマーク	`airwallex --confirm invoices mark-as-paid <id>`	billing-invoice mark-as-paid ツールを実行	ファイナライズ済みである必要。Airwallex 外で支払われた場合に使用。
サブスクリプションをキャンセル	`airwallex --confirm subscriptions cancel <id>`	subscription cancel ツールを実行	スキーマでフラグを確認。
カードを停止	`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>`	global-account close ツール（公開されている場合）	永続的。
カード所有者を削除	`airwallex --confirm cardholders delete <id>`	cardholder delete ツール（公開されている場合）	アクティブなカードがないことを確認。

エラー処理

状況	対応
必須項目が不足または曖昧	立ち止まり、不足している項目をリストアップし、ユーザーに確認
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 による自動翻訳です。