convex-suggest について
convex-suggestは、Convex開発向けのスキルです。コードや依頼に合う既存コンポーネントを検出し、現在のタスク完了後に根拠とともに1つ提案します。インストールは同意を得てから行います。
主な機能
- 01コンポーネントに合うコードパターンを検出
- 02一度に1つのコンポーネントを提案
- 03提案の根拠となるコードや依頼を提示
- 04同意を得てからインストール
活用シーン
- 01SMTPコードにメールコンポーネントを提案
- 02定期処理にcronコンポーネントを提示
- 03DBのレート制限カウンターに代替コンポーネントを提案
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-suggestインストール後、Claude Code で/convex-suggestを入力して読み込まれたか確認します。
詳細
適切な Convex コンポーネントを先回りして提案する
Convex コンポーネントがすでに実現している機能と重複するコードや意図を見つけたら、的を絞った提案を提示します。提案は「コンポーネントを 1 つ」「理由(ユーザー自身のコードや依頼に基づく)」「具体的なインストール方法」で構成します。明示的な同意なしにインストールしてはいけません。ユーザーから求められない限り、一度に複数のコンポーネントを提案してはいけません。
ワークフロー
codeSnippetsとuserAskを受動的に確認します。提案のために現在のタスクを中断してはいけません。- 検出ルール(
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。 - 現在のタスクを完了した後、提案を 1 つ提示します。コンポーネント名、検出のきっかけとなった具体的なコードやフレーズ、そのコンポーネントがより適している理由を示します。
- ユーザーが同意した場合は、
/add <component>を実行するか、検出器のinstallHintに従います。 - ユーザーが断るか、返答しない場合は、提案を取り下げます。同じ提案を繰り返してはいけません。
ルール
- 受動的に対応する — 現在のタスクを決して中断せず、ユーザーの依頼を完了した後に提案します。
- 提案は一度に 1 つだけ — 優先度が最も高いものを選び、コンポーネントを 5 つ並べてはいけません。
- 理由はユーザー自身のコードや依頼に基づいて示します — 「多くのユーザーが同時に呼び出すミューテーション内で
post.likes + 1と書かれているのを確認しました。この方法では、大規模な環境で OCC の競合が発生します。」 - 明示的な同意なしにインストールしてはいけません — 提案して理由を説明し、同意を待ちます。
- すでにインストールされているコンポーネントを提案してはいけません。
- Convex と無関係な一般的なコーディングの質問(配列のソートや CSS の記述など)では提案してはいけません。
コメント
Markdown 対応