mcpField
B
blitz-reviewer

blitz-reviewer

github.com/api-blitzテスト・品質162 回インストール3 日前に更新
リポジトリ

blitz-reviewer について

環境とアプリケーションコードのBlitz連携を監査し、合格・警告・失敗のチェックリストにまとめるスキルです。Blitz MCPのライブドキュメントを優先し、修正は確認後に行います。

主な機能

  1. 01Blitz MCP接続とライブスキーマの確認
  2. 02インストール済みSkillとSDKのバージョン確認
  3. 03Blitz呼び出しとリクエストの誤りを検査
  4. 04APIキーの状態とエンドポイント制限を報告
  5. 05確認待ちの修正項目を作成

活用シーン

  1. 01リリース前のBlitz連携の監査
  2. 02古いSDKやSkillの検出
  3. 03メソッド、リクエスト項目、列挙値の誤りの診断

MCP 対応

Blitz MCPが必要で、ライブのエンドポイントスキーマと列挙値を正とします。利用できない場合は同梱の参照スナップショットを使い、確度が下がることを示します。

インストール

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

$npx skills add https://github.com/api-blitz/skills --skill blitz-reviewer

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

同梱ファイル

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

references/
checklist.md
code-audit.md
key-and-rps.md
mcp-setup.md
scripts/
check_key.sh
check_mcp.sh
check_sdk.sh
check_skills.sh

詳細

Blitz Reviewer

Blitz の統合を監査し、環境（MCP、SDK、スキル、API キー）とユーザー自身のコード（メソッド、リクエスト本文、列挙値）について、正常な点、古くなっている点、問題がある点を報告します。

Blitz MCP が信頼できる唯一の情報源です。 記憶している API 仕様や同梱の API 仕様を基準に呼び出しを判断してはいけません。MCP に最新のエンドポイント、リクエスト本文、列挙値を問い合わせて比較してください。だからこそ、最初に MCP を確認し、徹底して利用します。これにより、ほかのすべてのチェックが正確になります。出力は合格／警告／不合格のチェックリストです。ユーザーが各修正を確認するまで、何も変更しません。

これは診断であり、リファクタリングではありません。読み取り専用のチェックを実行し、検出結果をひとつのレポートにまとめてから、確認を得た修正をひとつずつ、修正キューに沿って進めます。作業にクレジットを消費しないでください。key-info は無料です。「テスト」のために検索やエンリッチメントを実行してはいけません。

クイックスタート

チェックは順番に実行します（最初に MCP を確認します。これによってチェック 4～6 の信頼性が確保されます）。検出結果をすべて集めてから、ひとつのチェックリストと、確認後に着手する修正キューを提示します。

scripts/ と references/ のパスは、このスキル自体のディレクトリを基準とします。ヘルパーはそのディレクトリから実行してください（例：bash <skill-dir>/scripts/check_mcp.sh）。兄弟スキルへの参照（../blitz-create-script/...、../blitz-gtm-brainstorm/...）は、MCP を利用できない場合のスナップショットによる代替情報です。常にライブ MCP を優先してください。

ワークフロー

  1. MCP — 必須（最初に確認）。 Blitz MCP が接続されているか判断します。使用中のエージェントがどれであっても、そのエージェントから Blitz MCP ツール（search…blitz…、query_docs…blitz…）を利用できるか確認してください。不明な場合は、bash scripts/check_mcp.sh を実行します。MCP が見つからない場合は、そこで中断してユーザーにインストールを促してください。ユーザーが使っているエージェント（Claude Code、Cursor、VS Code、Windsurf、Codex、claude.ai など）に合わせた手順を案内し、https://docs.blitz-api.ai/guide/integrations/MCP をリンクして、追加作業も申し出てください。MCP があることで、チェック 4～6 を最新のスキーマに照らして検証できます。ユーザーが断った場合に限り、スナップショットの参照情報に切り替え、信頼度が低下することを明記してください。references/mcp-setup.md を参照してください。

  2. スキルを最新の状態に保つ。 bash scripts/check_skills.sh は、インストール済みプラグインのバージョンと api-blitz/skills の最新バージョンを比較します。古い場合は更新をキューに追加します。オフラインの場合は警告して次に進みます。

  3. SDK を最新の状態に保つ。 bash scripts/check_sdk.sh <python|javascript> は、インストール済みのバージョンと最新バージョン（PyPI の blitz-api-py／npm の blitz-api-js）を報告します。古い、またはインストールされていない場合は、アップグレードまたはインストールをキューに追加します。生の HTTP には絶対にフォールバックしないでください。

  4. コードをスキャンしてから、各呼び出しを MCP に照らして検証する。 プロジェクト内で Blitz の呼び出し箇所（インポート、client.search.*／.enrichment.*／.account.*、および api.blitz-api.ai への生の HTTP 呼び出し）を grep で検索します。それぞれについて、MCP に問い合わせて正確なエンドポイント、リクエスト本文のスキーマ、列挙値を取得し、比較します。不明または名称変更済みのメソッド、誤ったキーまたはキャメルケースの本文キー、大文字と小文字が違う列挙値（大文字と小文字が区別されるため、タイプミスがあってもエラーにならず、結果が何も返らないことがあります）、アンチパターンにフラグを付けます。問い合わせの例と grep のパターンについては、references/code-audit.md を参照してください。

  5. API キー、RPS、クレジット。 SDK（client.account.key_info()）または BLITZ_API_KEY=… bash scripts/check_key.sh を使って、キーの状態を読み取ります。valid、remaining_credits、max_requests_per_seconds、allowed_apis を報告します。制限は共有アカウントのプールではなく、エンドポイントごとに適用されます。したがって、rate_limit_rps がエンドポイントの許可 RPS を下回る場合と、複数のエンドポイントを同時に呼び出す際に、ひとつの共有クライアントがスロットリングしている場合の両方にフラグを付けます（各エンドポイントに専用のクライアントを用意してください。逐次実行のループでは、分割しても効果はありません）。ティアの変更をリクエストする前に、ユーザーに確認してください。references/key-and-rps.md を参照してください。

  6. 報告して修正する。 合格／警告／不合格のチェックリスト（形式は references/checklist.md を参照）を提示してから、修正キューの上から順に対応します。各修正は、ユーザーが確認した後にのみ適用してください。

ルール

  • まず MCP を使い、MCP の使用を促してください。MCP を信頼できる唯一の情報源とし、ユーザーが断った場合に限り、スナップショットの参照情報を使ってください。その場合は、レポートで信頼度が低いことを明記してください。
  • 診断に徹し、テストに費用をかけないでください。key_info のみを使用し、レビュー中に検索やエンリッチメントを実行してテストしないでください。
  • 明示的な確認なしに、何も変更しないでください。MCP のインストール、SDK やスキルのアップグレード、コードの編集、キーや RPS の変更は、いずれも承認を得てから行ってください。
  • API キー全体を表示したり、どこかに書き込んだりしないでください。sk_…last4 の形式でマスクしてください。
  • SDK の使用を徹底してください。api.blitz-api.ai に対する生の fetch／requests は、軽微な指摘ではなく問題として報告してください。

コメント

Markdown 対応