mcpField
N
nutmeg-review

nutmeg-review

github.com/withqwertyテスト・品質55163 回インストール今日更新
リポジトリ

nutmeg-review について

nutmeg-review は、サッカーデータのコードや可視化をレビューするスキルです。内容に応じてデータまたはチャートのレビュアーを割り当て、指摘事項を重大度別に整理します。

主な機能

  1. 01タスクに応じた専門レビュアーの割り当て
  2. 02サッカーデータ処理コードの確認
  3. 03チャートコードと表示のレビュー
  4. 04データとチャートの並行レビュー
  5. 05重大度別の指摘事項の整理

活用シーン

  1. 01試合データの取得・変換コードのレビュー
  2. 02サッカーデータのチャート表示の確認
  3. 03インタラクティブチャートの境界ケース検証
  4. 04データ処理とチャート描画の一括評価

インストール

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

$npx skills add https://github.com/withqwerty/nutmeg --skill nutmeg-review

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

詳細

レビュー

サッカーデータのコードや可視化について、正確性、規約への準拠、エッジケースを確認する専門レビュアーを呼び出します。

正確性

プロバイダー固有の事実に関する質問に答える前に、${CLAUDE_PLUGIN_ROOT}/docs/accuracy-guardrail.md を読み、その指示に従ってください。

最初に：プロフィールを確認する

.nutmeg.user.md を読みます。存在しない場合は、妥当なデフォルト（Python と pandas、中級レベル）で続行し、最後に /nutmeg のセットアップを実行するよう提案してください。

対象範囲を判断する

ユーザーが何をレビューしてほしいのかを確認します。関連ファイルを読み、どのレビュアーを呼び出すか判断してください。

シグナル呼び出すレビュアー
コードがサッカーデータを処理する（取得、フィルタリング、変換、指標の計算）data-reviewer エージェント
コードがチャートや可視化を描画するchart-reviewer エージェント（モード 1：コードレビュー）
ユーザーが URL を提示する、または「見た目を確認して」と依頼するchart-reviewer エージェント（モード 2：視覚的な確認）
チャートにフィルター、ツールチップ、状態、または動的データがあるchart-reviewer エージェント（モード 3：インタラクティブなエッジケース）
コードが @withqwerty/campos-* をインポートする（React + campos）chart-reviewer エージェント（モード 4：React + Campos）。コンテキストに ${CLAUDE_PLUGIN_ROOT}/skills/_shared/campos-bridge.md を渡してください
コードがデータ処理とチャート描画の両方を行う両方のエージェントを並行して呼び出す

少なくとも 1 つは必ず呼び出してください。 判断が難しい場合は、両方を呼び出してください。重複した指摘があるほうが、問題を見逃すより適切です。

モード 4 の検出：レビュー対象ファイルで @withqwerty/campos- または from "@withqwerty/campos を grep します。一致するものがあれば、モード 1 に加えてモード 4 も有効になります。

呼び出し

複数のエージェントを呼び出す場合は、並行して起動してください。各エージェントには以下を渡します。

  1. レビュー対象のファイルパス
  2. ユーザーのプロフィール（言語、プロバイダー、経験レベル）
  3. 実行するモード（chart-reviewer の場合）
  4. コンテキスト：ユーザーが作成したものと、懸念している点
Data reviewer のプロンプトテンプレート
Review the football data code in [FILE_PATHS].

The user is working with [PROVIDER] data in [LANGUAGE].
They built: [DESCRIPTION]
Their concern: [WHAT_THEY_SAID]

Follow the full review checklist in your agent prompt. Use search_docs to verify
provider-specific facts (coordinate systems, qualifier IDs, event types).
Chart reviewer のプロンプトテンプレート
Review the chart code in [FILE_PATHS].

Mode(s): [Code Review / Visual Inspection / Interactive Edge Cases]
The user is building: [DESCRIPTION]
Their concern: [WHAT_THEY_SAID]
Stack: [LANGUAGE + LIBRARIES from profile]
[If visual inspection: URL or instructions to render]

Load ${CLAUDE_PLUGIN_ROOT}/skills/brainstorm/references/chart-canon.md for convention checking.

指摘事項を統合する

両方のエージェントから報告を受け取ったら、以下を行います。

  1. 重複を統合する — 両方が同じ問題（例：座標系の誤り）を指摘した場合は、1 つにまとめます
  2. 深刻度順に並べる — 重大、警告、情報の順にします
  3. 論理的に分類する — データの問題、描画の問題、規約の問題、エッジケースの順にします
  4. 簡潔に提示する — 深刻度、場所、問題、修正方法を表形式にします

視覚的な確認を提案するタイミング

chart-reviewer のコードレビューで、出力を見ないと確認できない描画上の問題が見つかった場合は、次のように提案します。

「コードレビューで、描画に関する問題の可能性が [N] 件見つかりました。チャートを視覚的に確認しましょうか？URL を教えていただくか、ローカルで実行してください。」

視覚的な確認を必須にしないでください。チャートをローカルで簡単に配信できないユーザーも多くいます。コードレビューだけでも、ほとんどの問題を見つけられます。

レビュー後

指摘事項がある場合：

  • どれを修正するかユーザーに尋ねる
  • 重大な問題については、直接修正することを提案する
  • 警告や情報レベルの問題については、トレードオフを説明し、ユーザーに判断を委ねる

指摘事項がない場合：

  • そのことを明確に伝えます。レビューを正当化するために問題を作り出さないでください。
  • 必要に応じて、確認した内容を伝え、レビューが十分に行われたことが分かるようにします。

コメント

Markdown 対応