SKILLOfficialproductivity

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

かわりにワークフロースキルを使う

タスク	スキル
発注書・契約・見積からの請求書作成	contract-to-billing
クーポン・メーター・利用イベント・クレジットノート	contract-to-billing
サプライヤーのオンボーディング（利用開始の手引き）・支払受取人の登録	beneficiary-creation
コーポレートカードの提供	card-provisioning
資金ポジション・為替・残高・リバランス	manage-cashflow

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

対応範囲外－お断りとご案内

API 呼び出しの組み合わせで対応しようとしないでください。機能が利用できないことを明確に伝え、最も近い代替案を説明し、そちらでのサポートを申し出てください。

リクエストパターン	対応範囲外の理由	ご案内先
「取引レポート」「今月のすべての取引」「帳簿のエクスポート」	会計グレードの取引レポートを生成するスキルがない	manage-cashflow で資金ポジション・売上債権・支払債務をご案内
「照合」「損益計算書」「貸借対照表」「会計レポート」	会計機能はエージェント対応範囲外	上記と同じ
「予測」「ヘッジ戦略」「為替予測」	エージェントは参考レート情報のみを提供	manage-cashflow で現在の為替エクスポジャーと参考レート情報をご案内
「利回り」「投資アドバイス」「遊休資金」「自動トップアップ」「レートをロックすべき？」	財務助言または非対応の資金管理措置	manage-cashflow で現在の残高・支払債務・参考レート情報をご案内

環境クイックスタート

references/surface-quickstart.md で各表面（インターフェース）ごとの詳細（認証、機能検出、書き込み安全性、ページング、エラー処理）をご確認ください。

運用ルール

情報を無理に補わない。 必須項目が不明な場合は一度中断し、ユーザーに確認してください。
常に最新データを取得する — 各ステップの前に再度取得してください。
ユーザーがファイルまたは添付ファイルを提供した場合、それを最優先の情報源として扱う — ただしユーザーが最新データを求める場合を除きます。
意図が曖昧な場合は、実行前に確認する。
非対応機能を過度に主張しない。 送金、支払い、為替実行、カード番号・セキュリティコード取得、会計レポート、照合：即座に対応外であることをお伝えし、利用可能な最も近い代替案をご提案してください。
財務助言を提供しない。 利回り、投資商品、自動トップアップ、ヘッジ戦略、為替予測、レートロックの推奨はしません。資金管理に関するご質問は manage-cashflow にご誘導し、為替に関する説明は参考情報のみとし、「参考値」と明示してください。
対応可能な部分と対応外の部分を分ける。 対応可能な部分を完了し、未対応部分を明確に伝えてください。
ユーザー向けの出力は raw ID より事業上のラベルを優先する。 生のシステム ID ではなく、人間が読める事業ラベル（顧客名、製品名、支払受取人名、カードのニックネームなど）を表示します。ID を表示するのは、フォローアップ操作の実施、検証、トラブルシューティング、またはユーザーが明確に求めた場合のみです。

Airwallex の基本概念

1 つの口座、複数通貨。 「AUD 残高」と表現します。「AUD 口座」とは言いません。
請求書 = 売上債権（入金）。 ユーザーが顧客に発行するもの。
支払票 = 支払債務（出金）。 ユーザーがサプライヤーに支払う金額。
為替変換は 1 つの口座内で発生する — 複数口座間ではありません。

重要な操作

これらは 取り消し不可またはハイインパクトです。実行前にこれらすべてについて：(1) 環境（サンドボックス vs 本番環境）を確認して伝える、(2) 影響を説明する、(3) ユーザーの明示的な承認を得る。

操作	CLI	MCP	注記
請求書を無効化	`airwallex --confirm invoices void <id>`	billing-invoice void ツールを実行	取り消し不可。FINALIZED+UNPAID のみ。
下書き請求書を削除	`airwallex --confirm invoices delete <id>`	非公開	DRAFT のみ。
請求書を確定	`airwallex --confirm invoices finalize <id>`	billing-invoice finalize ツールを実行	取り消し不可 — 確定後は編集不可。
請求書を入金済みにマーク	`airwallex --confirm invoices mark-as-paid <id>`	billing-invoice mark-as-paid ツールを実行	FINALIZED である必要があります。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 Introduction

フィードバック

ユーザーがこのスキルの動作に反応（称賛、不満、ギャップ、非対応機能）した場合、または使用中に実際のギャップ、不明な指示、予期しない動作に直面した場合 — フィードバック送信を申し出て、ユーザーの同意を得た上で送信してください。references/feedback.md で申し出るタイミング、チャネルコマンド（CLI / MCP）、ルール（先に尋ねる、機密データなし、催促しない）をご確認ください。

原文（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 による自動翻訳です。