metamask-agent-workflows

MetaMask エージェントのワークフロー

mm CLI で繰り返し使用できる複数ステップのパターンです。ユーザーの依頼が単一のコマンドではなくパターンの場合は、ワークフローファイルを読み込みます。

ワークフローの振り分け

パターン	ワークフロー
初回セットアップとオンボーディング	onboarding.md
ログインフロー	login.md
トラブルシューティングの判断ツリー	troubleshooting.md
スワップの見積もり・確認・実行フロー	swap.md
ブリッジの見積もり・確認・実行フロー	bridge.md
パーペチュアルポジションを開くフロー	perps-open-position.md
パーペチュアルポジションを閉じるフロー	perps-close-position.md
パーペチュアルポジションを変更するフロー	perps-modify-position.md
Predict の初回セットアップと認証情報	predict-setup.md
Predict ウォレットへの pUSD の入金または出金	predict-funding.md
予測市場の検索と閲覧	predict-markets.md
予測注文の見積もりと発注	predict-place-order.md
Predict の注文とポジションの表示またはキャンセル	predict-manage-orders.md
Predict のポートフォリオの表示と利益の引き出し	predict-portfolio.md
トークンの検索、価格、市場データ	market-data.md
Aave V3 への資産の供給	aave-supply.md
Aave V3 からの資産の出金	aave-withdraw.md
Aave V3 からの借入	aave-borrow.md
Aave V3 の負債の返済	aave-repay.md
Aave V3 の担保の切り替え	aave-collateral.md
Aave V3 のポジションとヘルスファクターの確認	aave-positions.md
Aave V3 のトークン、金利、流動性の検索	aave-markets.md

ユーザーが別の形式を明示的に要求しない限り、コマンド出力には常に --toon を使用してください。

事前確認

セッションで最初の CLI 操作を行う前に、以下の確認を順番に実行します。

1. バージョンの互換性

このスキルは @metamask/agentic-cli v4.0.0 向けに作成されています（フロントマターの cliVersion を参照）。インストール済みのバージョンを確認します。

mm --version

インストール済みのバージョンは、@metamask/agentic-cli/ の後に続く値です（例：@metamask/agentic-cli/2.0.0 darwin-arm64 node-v22.18.0）。その major.minor を固定された cliVersion と比較します。任意で、公開されている最新バージョンも確認します（ベストエフォートで実施し、ネットワーク障害時は何もせずにスキップします）。

npm view @metamask/agentic-cli version

インストール済みの major.minor が固定された cliVersion と異なる場合、またはインストール済みのバージョンが最新リリースより古い場合は、ユーザーに一度警告してから続行します。

バージョンの不一致：インストール済みの CLI は <installed>、このスキルの固定バージョンは 4.0.0、最新リリースは <latest> です。バージョンがそろうまでは、このスキルに記載されたコマンド構文が正確でない可能性があります。npm install -g @metamask/agentic-cli@latest で CLI を更新し、続いて npx skills add metaMask/agent-skills でスキルを再インストールしてください。

この確認はセッションごとに一度実行します。この確認によって操作をブロックしないでください。

2. 準備状況の確認（認証＋初期化）

mm doctor は唯一の準備状況チェックです。セッションで最初の CLI 操作を行う前に実行してください。

mm doctor

authenticated のブール値、initialized のブール値、および hints のリストが報告されます。**mm doctor で authenticated: true と initialized: true の両方が報告されるまで、ほかのコマンドを実行しないでください。**認証と初期化は独立した条件です。プロジェクトでウォレットモードが選択されていない場合でも、セッションは認証済みになり得ます。その場合、ウォレットを必要とするコマンドは実行前に中断し、NOT_INITIALIZED — 「プロジェクトが初期化されていません。」（ヒント：mm init を実行してウォレットモードと取引モードを設定してください。）が返されます。

プロジェクトが初期化済みと見なされるのは、ウォレットモードが設定されている場合のみです。また、server-wallet の場合は取引モードも設定されている必要があります（byok ではウォレットモードのみが必要です）。確認に mm init show は使わないでください。このコマンドは初期化済みのプロジェクトを必要とするため、未初期化のプロジェクトでは状態を報告する代わりに NOT_INITIALIZED が発生します。

修正したら、再度 mm doctor を実行し、ほかの操作を行う前に問題がないことを確認してください。

• authenticated: false → workflows/login.md（初回セットアップの場合は workflows/onboarding.md）に従って mm login を実行します。
• authenticated: true かつ initialized: false → workflows/onboarding.md に従って mm init を実行し、ウォレットモード（および server-wallet の場合は取引モード）を選択します。

コマンドの確認

コマンドを組み立てる前に、mm <command> --help を実行して正確なフラグ、構文、デフォルト値を確認してください。記憶を頼りにフラグを推測しないでください。

出力ルール

• ワークフローを黙って切り替えてください。読み込むワークフローを告げないでください。
• コマンドのエラーはそのまま提示してください。隠したり、言い換えたりしないでください。
• コマンドが失敗した場合は、mm <command> --help を確認し、それに基づいて案内してください。