mcpField
C
convex-optimize

convex-optimize

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

convex-optimize について

convex-optimize は、既存の Convex アプリを評価・改善するスキルです。launch-readiness の結果にコンポーネント更新とオブザーバビリティ対応を組み合わせ、変更前に確認を求めます。

主な機能

  1. 01Convex アプリとデプロイ種別の検出
  2. 02launch-readiness による評価
  3. 03固定バージョンのコンポーネント更新確認
  4. 04オブザーバビリティ不足時に sentinel を提案
  5. 05確認後に修正を適用
  6. 06再評価してスコア差を報告

活用シーン

  1. 01セキュリティとデータ損失リスクの優先対応
  2. 02古い Convex コンポーネントの更新
  3. 03本番環境のエラー捕捉の追加
  4. 04修正後の評価変化の確認

インストール

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

$npx skills add https://github.com/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 の優先順位に従い、スタイルよりもセキュリティとデータ損失のリスクを優先します。
  • 既存の本番アプリに変更を自動適用しないでください。適用後に再評価し、スコアの変化を示してください。

コメント