SKILL ARTICLE / vercel-optimize
Vercel Optimizeで本番の数字から改善点を絞る
コードを探す前に本番の数字を見る
Vercelのメトリクスや利用状況から調査対象を絞り、根拠を確認した改善案だけを残す監査Skillです。
OVERVIEW → CAN DO → BUILD
知ったことをSkillづくりに活かす
本番メトリクスを主な入口に、決められた条件を通った候補へ調査を絞っている
観測値と対象ファイルを結びつけ、根拠のある改善候補から着手できる
このSkillは、複数のコマンド結果や設定をsignals.jsonへ集めてから判断します。自分たちのSkillでも、AIへ断片的なログを順番に読ませるだけでなく、入力元、確認期間、欠損、対象環境をそろ...
01 / OVERVIEW
Skillの概要
Vercel Optimizeは、Vercel上で動くアプリのコスト、性能、信頼性、キャッシュ、Function利用状況などを調べる公開Skillです。最初にリポジトリ全体から問題らしきコードを探すのではなく、Vercelのメトリクス、利用量、プロジェクト設定とコードスキャンの結果を集め、signals.jsonという証拠ファイルにまとめます。
次に、決められた条件で調査候補を選びます。候補になったルートやファイルだけを詳しく読み、提案を作った後も、実在するファイル、引用先、フレームワークのバージョンに合っているかを別の工程で検証します。根拠を満たさない提案は、そのまま報告へ出さない設計です。
確認したversion 1.2.0では、Node.js 20以上とVercel CLI v53以上が必要です。Vercelへログインし、監査するアプリのディレクトリを対象プロジェクトへlinkしてから使います。Next.js、SvelteKit、Nuxtが主な対応対象で、Astroは限定対応です。その他のフレームワークでは、範囲を限った監査を続けるか利用者へ確認します。
02 / CAN DO
できるようになること
実際にトラフィックや負荷が集まっている場所から調査を始められるため、影響の小さいコードへ時間を使いすぎずに済みます。遅いルート、キャッシュの候補、Function利用量などを、観測した数値と対象ファイルを結びつけながら整理できます。
一方で、これは改善の自動実装や削減額を保証するSkillではありません。ルート単位のメトリクスに基づく提案にはObservability Plusが必要で、トラフィックが少ない場合は十分な順位づけができません。対象プロジェクトやアカウントを特定できないときも、推測で進めず確認を求めます。
活かしやすい場面
- Vercel上で動くアプリの性能監査
- Function利用量やキャッシュ状況の整理
- 改善候補が多すぎて優先順位を決めにくい場面
使う前に確認したい場面
- Vercelに未接続のプロジェクトを推測だけで診断すること
- 計測値を確認せず削減効果や性能向上を保証すること
- 対応外フレームワークを確認なしで詳しく監査すること
03 / BUILD
自分たちのSkill作成に活かせること
文章やコードをそのまままねるのではなく、自分たちのSkillに取り入れたい判断基準や工程の分け方を整理しました。
判断より先に証拠を一つにまとめる
このSkillは、複数のコマンド結果や設定をsignals.jsonへ集めてから判断します。自分たちのSkillでも、AIへ断片的なログを順番に読ませるだけでなく、入力元、確認期間、欠損、対象環境をそろえた証拠ファイルを先に作ると、途中で前提が入れ替わりにくくなります。
調べる範囲を機械的な条件で決める
どのルートを調べるかをAIの勘に任せず、同じ入力なら同じ候補になる条件で選んでいます。監査Skillを作るときは、件数上限、優先順位、見送る閾値をスクリプト側へ寄せると、毎回範囲が広がるのを防げます。
提案を作る工程と確かめる工程を分ける
生成した提案は、ファイルの実在、引用先、対象バージョンとの適合を別工程で確認します。自分たちのSkillにも、結果をきれいに書く前に、主張ごとの根拠、対象ファイル、適用条件を機械的に照合する段階を置くと、もっともらしい誤りを減らせます。
04 / WORKFLOW
実際に使うときの流れ
- 01
対象を確定
Vercelプロジェクト、アカウント範囲、フレームワーク、必要な権限を確認する。
- 02
信号を収集
メトリクス、利用量、設定、コードスキャンを一つの証拠ファイルへまとめる。
- 03
候補を限定
決められた条件を通過したルートや設定だけを調査し、範囲を勝手に広げない。
- 04
提案を検証
対象ファイル、観測値、引用先、フレームワークのバージョンを照合してから報告する。
05 / TRY
試すときに使える依頼文
最初は、結果を自分で確かめやすい題材に使ってみてください。Skillがどこまで判断できるのか、どこで人の確認が必要なのかがわかります。
このVercelプロジェクトの性能と利用状況を監査してください。最初に対象プロジェクトとアカウント範囲を確認し、メトリクスと設定を集めてください。数値が示したルートやファイルを優先し、トラフィックに左右されない設定・スキャン項目は分けて報告してください。各提案には観測値または採用した条件、対象ファイル、適用する公式資料、確認方法を付け、根拠が足りない候補は改善案として出さないでください。変更の実装はせず、優先順位つきの監査結果までにしてください。
06 / INSTALL
導入方法を確認する
コマンドや配置方法は更新されることがあります。実行する前に、公開元の最新READMEとライセンスを確認してください。
npx skills add vercel-labs/agent-skills --skill vercel-optimize
npx skills add vercel-labs/agent-skills --skill vercel-optimize
07 / WATCHOUTS
人が確認するところ
- Vercelの認証トークンを依頼文やシェルコマンドへ直接書かないでください。
- 対象プロジェクトとチームまたは個人アカウントの範囲を確認してから計測してください。
- トラフィックが少ない場合やObservability Plusを利用できない場合は、調査範囲が限られることを結果に残してください。
- 改善案を本番へ反映する前に、変更差分、計測方法、ロールバック手順を人が確認してください。