SKILLKnowledge Workproductivity

awx-best-practices

プラグイン: Airwallex AgentOS
ソース: 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 で現在のエクスポージャーと参考値の為替レートを提供
「利回り」「投資アドバイス」「遊休資金」「自動トップアップ」「レートをロックすべき？」	財務アドバイスまたは非対応の資金運用アクション	manage-cashflow で現在の残高、債務、参考値の為替情報のみを提供

環境クイックスタート

認証・検索・書き込み安全性・ページネーション・エラーハンドリングなど、サーフェス（インターフェース）ごとの詳細は references/surface-quickstart.md を参照してください。

運用ルール

不足している情報を作り上げたり仮定したりしないでください。 必須フィールドが不確実な場合は中断して、ユーザーに確認してください。
常に新しいデータを取得してください — 各ステップ前に再取得してください。
ユーザーがファイルまたは添付ファイルを提供した場合、ライブデータを求めない限り、それを最終的な情報源として扱ってください。
意図が曖昧な場合は、実行前に確認してください。
対応していない機能を主張しないでください。 送金、払出、為替実行、PAN/CVV 取得、会計レポート、照合：即座に拒否し、何が対応していないかを述べ、最も近い代替案を提供してください。
財務アドバイスを提供しないでください。 利回り、投資商品、自動トップアップ、ヘッジ戦略、為替予測、レートロックを勧めないでください。資金運用に関する質問については manage-cashflow にリダイレクトし、為替に関する説明は参考値として明確にラベルを付けてください。
対応している部分と対応していない部分に分けてください。 対応している部分を完了し、対応していない部分を明確に述べてください。
ユーザーに表示する場合、生のシステムID ではなく分かりやすいラベルを優先してください。 可能な限り、顧客名、商品名、受取人名、カードニックネームなどの分かりやすいラベルを表示し、生のシステムID は表示しないでください。ID は操作上必要な場合（後続アクション、確認、トラブルシューティング）または、ユーザーが明確に要求した場合のみ表示してください。

Airwallex の中核概念

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

重要な操作

これらは取り消し不可または影響が大きい操作です。これらを実行する前に：(1) 環境（サンドボックス対本番）を確認して述べ、(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>` 本文 `{"status":"INACTIVE"}`	card-update ツール（`card_status: INACTIVE`）	取り消し可能。references/api_traps.md でここで設定できない状態を確認。
カードを閉鎖	`cards update <id>` 本文 `{"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 を使用している場合は一度再試行（自動更新）。再試行が失敗した場合、ユーザーにどちらの環境かを確認し、自分で `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
"Transaction report", "all transactions this month", "ledger export"	No skill produces accounting-grade transaction reports	Offer manage-cashflow for cash position, receivables, obligations
"Reconciliation", "P&L", "balance sheet", "accounting report"	Accounting functions outside agent capability	Same as above
"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, accounting reports, reconciliation: 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 による自動翻訳です。