mcpField
C
convex-suggest

convex-suggest

github.com/convex開発6936.9k 回インストール1 日前に更新
リポジトリ

convex-suggest について

convex-suggest は、コードや依頼に Convex コンポーネントが適する場面を見つけるコーディングスキルです。現在のタスクの後にコードを根拠とする提案を一つ示し、明示的な同意を得てからインストールします。

主な機能

  1. 01コンポーネント関連パターンの検出
  2. 02パターンと Convex コンポーネントの対応付け
  3. 03対象を絞った提案を一つ提示
  4. 04コードに基づく理由の説明
  5. 05同意を得てからインストール

活用シーン

  1. 01繰り返されるバックエンド処理に合うコンポーネント探し
  2. 02独自実装の代替案の検討
  3. 03コード内のコンポーネント適用機会の確認

インストール

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

$npx skills add https://github.com/convex/agent-skills --skill convex-suggest

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

詳細

適切な Convex コンポーネントを先回りして提案する

Convex コンポーネントがすでに実現している機能と重複するコードや意図を見つけたら、的を絞った提案を提示します。提案は「コンポーネントを 1 つ」「理由(ユーザー自身のコードや依頼に基づく)」「具体的なインストール方法」で構成します。明示的な同意なしにインストールしてはいけません。ユーザーから求められない限り、一度に複数のコンポーネントを提案してはいけません。

ワークフロー

  1. codeSnippets と userAsk を受動的に確認します。提案のために現在のタスクを中断してはいけません。
  2. 検出ルール(generators/suggest-detector.mjs を参照)と照合します。email/SMTP → resend、プッシュ通知 → expo-push、setInterval/cron → @convex-dev/crons、共有カウンターのインクリメント → @convex-dev/sharded-counter、.collect().length による走査 → @convex-dev/aggregate、複数ステップ/長時間実行のアクション → @convex-dev/workflow、同時実行数の制限 → @convex-dev/workpool、DB 内のレート制限カウンター → @convex-dev/rate-limiter、fs.write/S3 アップロード → Convex Storage、Elasticsearch/Algolia → 組み込みの全文検索、プレゼンス/入力中表示 → @convex-dev/presence、Pinecone/外部ベクトル DB → @convex-dev/rag、共同編集 → @convex-dev/prosemirror-sync。
  3. 現在のタスクを完了した後、提案を 1 つ提示します。コンポーネント名、検出のきっかけとなった具体的なコードやフレーズ、そのコンポーネントがより適している理由を示します。
  4. ユーザーが同意した場合は、/add <component> を実行するか、検出器の installHint に従います。
  5. ユーザーが断るか、返答しない場合は、提案を取り下げます。同じ提案を繰り返してはいけません。

ルール

  • 受動的に対応する — 現在のタスクを決して中断せず、ユーザーの依頼を完了した後に提案します。
  • 提案は一度に 1 つだけ — 優先度が最も高いものを選び、コンポーネントを 5 つ並べてはいけません。
  • 理由はユーザー自身のコードや依頼に基づいて示します — 「多くのユーザーが同時に呼び出すミューテーション内で post.likes + 1 と書かれているのを確認しました。この方法では、大規模な環境で OCC の競合が発生します。」
  • 明示的な同意なしにインストールしてはいけません — 提案して理由を説明し、同意を待ちます。
  • すでにインストールされているコンポーネントを提案してはいけません。
  • Convex と無関係な一般的なコーディングの質問(配列のソートや CSS の記述など)では提案してはいけません。

コメント