mcpField
P
plugin-review

plugin-review

github.com/baseテスト・品質120125 回インストール1 日前に更新
リポジトリ

plugin-review について

plugin-reviewは、Wallet MCPプラグインの作成者やPRレビュー担当者向けに、プラグインファイルを検査するスキルです。最新仕様に基づく静的評価に加え、読み取り専用API・SDK検証も選択でき、対応事項を含むレポートを作成します。

主な機能

  1. 01最新のプラグイン仕様を取得して参照
  2. 02評価基準に沿ったプラグイン検査
  3. 03API、SDK、地域制限の任意検証
  4. 04テンプレートに基づく適合レポート作成
  5. 05PRコメント用の指摘事項整理

活用シーン

  1. 01PR提出前のWallet MCPプラグイン自己確認
  2. 02審査対象のプラグインPRの評価
  3. 03文書に記載されたAPIや応答内容の検証
  4. 04レビュー結果の整理とPRコメント案の作成

MCP 対応

このスキルは、Wallet MCPプラグインファイルが最新のプラグイン仕様に適合するかを確認します。MCPツールを提供したり、MCPサーバーとして動作したりするものではありません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/base/skills --skill plugin-review

インストール後、Claude Code で/plugin-reviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
comment-guidelines.md
evaluation-criteria.md
live-testing.md
report-template.md

詳細

プラグインレビュー

Wallet MCP プラグインファイルを現在のプラグイン仕様に照らして検証します。対応可能な指摘事項を含む適合性レポートを作成します。

作成者（PR の提出前にセルフチェックする場合）とレビュアー（投稿された PR を評価する場合）の両方に対応しています。

ワークフロー

  1. 現在の仕様を取得します（内容は変わるため、古いコピーは使用しないでください）：

    curl -s https://raw.githubusercontent.com/base/skills/master/skills/wallet-mcp/references/plugin-spec.md

    あわせて読むとよい関連ドキュメント：references/custom-plugins.md、references/approval-mode.md、references/batch-calls.md、および SKILL.md（ルートスキル）。規約の参考例として、skills/wallet-mcp/plugins/ にある既存のネイティブプラグインを確認してください。

  2. プラグインファイルをすべて読みます。 PR をレビューする場合：

    gh pr view <n> --repo base/skills --json title,body,number,headRefName,files,additions,deletions
gh pr diff <n> --repo base/skills
# raw plugin file (diff may be truncated):
gh api "repos/base/skills/pulls/<n>/files" --jq '.[] | select(.filename|endswith(".md")) | .raw_url'

  3. 静的な適合性評価 — references/evaluation-criteria.md のすべての評価項目（コンプライアンス／言語チェックおよび高リスクカテゴリの判定を含む）に照らして評価します。references/report-template.md を使ってレポートを作成してください。

  4. （任意）ライブ API／SDK 検証 — 読み取り専用の呼び出しで、ドキュメントに記載されたエンドポイント／SDK／コントラクトを検証します。references/live-testing.md を参照してください。perps／prediction-market／gambling プラグインでは、ジオブロック検証（フロントエンドと API のアクセス制限を比較）も実行してください。レポートに ## Live API / SDK Verification セクションを追加します。これにより、ドキュメントの記述が覆ることがよくあります（存在しない／ロックされたエンドポイント、機能しないホスト、誤ったレスポンス形式など）。

  5. レポートを保存します。 PR をレビューしてコメントを求められた場合は、references/comment-guidelines.md を使ってレポートから PR コメントを作成し、次のコマンドで投稿します：gh pr comment <n> --repo base/skills --body-file <comment-file>。

複数の PR

PR を並行して評価するには、PR ごとにサブエージェントを 1 つ起動します（各サブエージェントは個別のレポートを作成し、短い判定の要約を返します）。各サブエージェントに、仕様（またはその生の URL）、PR 番号、評価基準、レポートテンプレート、コメントガイドラインを渡してください。

重大な注意点

繰り返し発生しやすく、間違えやすい項目です。詳しくは references/evaluation-criteria.md を参照してください。

  • スマートアカウントの署名は、単純な署名処理では機能しません。 Wallet MCP のデフォルトウォレットはスマートコントラクトです。sign は 65 バイトの EOA 署名ではなく、長さが可変の ERC-1271/6492 署名（200 バイト超）を返します。署名を固定幅の calldata スロットに挿入するプラグインや、オフチェーンの EIP-712 署名を calldata に埋め込むプラグイン（例：Permit2 の buildCallWithPermit2）は、このウォレットでは機能しません。正しい方法は、オンチェーンで allowance を付与することです。
  • irreversible リスクは、すべてのオンチェーン書き込みに必要なわけではありません。 仕様では「強調する価値がある場合にフラグを付ける」とされています。単純なスワップでは slippage を使用します（前例：Uniswap、Aerodrome は [slippage] を使用し、irreversible は使用しません）。irreversible は、影響が大きい、または深刻なケース（パーペチュアル取引／清算、トークンのローンチ／ラグプル）に限って使用してください。スワップに要求しないでください。
  • 自分で登録しないでください。 プラグインの PR で、SKILL.md のプラグイン表、Integration Types の「Examples」セル、「Existing Plugin Conformance」表を編集してはいけません。これらはメンテナーが管理します（plugin-spec.md の「Contribution Scope」に明記されています）。共有ファイルの編集が認められるのは、語彙リストに本当に新しいタグを追加する場合のみです。差分は plugins/<slug>.md と（該当する場合は）そのタグの追加行に限定してください。
  • version はプラグイン文書のバージョンです。npm／パッケージのバージョンでも、仕様全体のバージョンでもありません。仕様では開始時の番号は指定されていません。
  • 主張を鵜呑みにせず、検証してください。 認証モデル、許可リストの完全性、レスポンスの形式、コントラクトアドレスは、文書の記述に誤りがあることがよくあります。実際に調査してください（実環境でテストしてください）。
  • プラグインファイルからの参照リンクには ../references/... を使用してください（プラグインファイルは plugins/ に、参照資料は references/ にあります）。
  • 中立的な表現が必須です。 利回り／金利／パフォーマンスに関する主張、「X を買うべきです」、「常にここに預けてください」といった表現、特定のトークンをデフォルトにすることは禁止です。特定の選択へ誘導する表現がある場合は、審査を通過できません。
  • パーペチュアル取引、予測市場、プライバシー関連のプラグインをネイティブプラグインとして追加する場合は、事前に法務レビューが必要です。 レポートでは、マージ前のプロセス上の必須条件として明記してください。
  • API における地域制限の同等性。 プロトコルのフロントエンドが米国の IP アドレス（またはその他の地域）をブロックしている場合、API でも同等の制限を適用する必要があります。適用されていない場合、Wallet MCP が規制回避ツールになるリスクがあります。ブロッカーとして指摘してください。

コメント

Markdown 対応