mcpField
C
convex-optimize

convex-optimize

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

convex-optimize について

convex-optimizeは、既存のConvexアプリを監査・改善するスキルです。スコア付きの準備状況レポートにコンポーネント更新と任意の可観測性設定を組み合わせ、確認後にのみ変更を適用します。

主な機能

  1. 01スコア付きの準備状況評価を依頼
  2. 02固定されたConvexコンポーネントの更新を確認
  3. 03可観測性の不足にsentinelを提案
  4. 04優先順位付きの修正計画を提示
  5. 05再評価してスコアの変化を報告

活用シーン

  1. 01Convexアプリのセキュリティとデータ損失リスクを確認
  2. 02古いConvexコンポーネントの更新を計画
  3. 03本番エラー捕捉の不足に対処

インストール

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

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

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

詳細

既存の Convex アプリを監査して最適化する

既存アプリを改善するためのワークフローです。スコア付きの評価から始め、その結果に基づいて対応します。古くなったコンポーネントをアップグレードし、可観測性を設定します。計画、確認、適用の順で進めます。評価そのものは launch-readiness(findings-bus のスコアリング機能)に委任します。optimize 独自の価値は、その結果に対して実際に対応することです。

ワークフロー

  1. アプリを検出します。convex/ ディレクトリ、スキーマ、匿名デプロイかクラウドデプロイかを確認します。
  2. launch-readiness を使って評価します。authz/reviewer/advisor/insights を横断した、スコア付きで重複を除いたレポートと、優先順位付きの修正計画を作成します。これらのチェックを手動で再実行しないでください。optimize は監査を再実装するのではなく、launch-readiness のレポートを利用します。
  3. アップグレードします。固定された @convex-dev/* コンポーネントに対して check-updates を実行し、古いコンポーネント(古さの分類)に関する指摘を同じ計画にまとめます。
  4. 可観測性を確認します。準備状況レポートで可観測性の不足(本番環境のエラーキャプチャがないこと)が指摘された場合は、sentinel のインストールを提案します。
  5. 優先順位を付けた計画を提示します。launch-readiness のスコア、修正計画、アップグレード、可観測性をまとめ、セキュリティとデータ損失のリスクを最優先します。明示的な確認を得てから適用し、各修正は対応する fixCapability に振り分けます。
  6. 適用後、launch-readiness の評価を再実行し、スコアの変化を示します。

ルール

  • まず読み取り専用で進めます。ファイルを変更する前に計画を提示し、確認を得てください。
  • 監査は launch-readiness(findings-bus のスコアリング機能)に委任してください。reviewer/advisor/insights をインラインで再実装しないでください。optimize の役割は、レポートに基づいて対応すること(アップグレードと可観測性の整備)であり、スコアを再評価することではありません。
  • launch-readiness の優先順位に従い、スタイルよりもセキュリティとデータ損失のリスクを優先します。
  • 既存の本番アプリに変更を自動適用しないでください。適用後に再評価し、スコアの変化を示してください。

コメント