mcpField
C
convex-suggest

convex-suggest

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

convex-suggest について

convex-suggestは、Convex開発向けのスキルです。コードや依頼に合う既存コンポーネントを検出し、現在のタスク完了後に根拠とともに1つ提案します。インストールは同意を得てから行います。

主な機能

  1. 01コンポーネントに合うコードパターンを検出
  2. 02一度に1つのコンポーネントを提案
  3. 03提案の根拠となるコードや依頼を提示
  4. 04同意を得てからインストール

活用シーン

  1. 01SMTPコードにメールコンポーネントを提案
  2. 02定期処理にcronコンポーネントを提示
  3. 03DBのレート制限カウンターに代替コンポーネントを提案

インストール

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

$npx skills add https://github.com/get-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 の記述など)では提案してはいけません。

コメント