add-model-price

モデル価格の追加

このスキルは、worker/ のモデル価格の変更と、packages/shared/ の LLM 型の共有更新に使用します。

適用する場合

• worker/src/constants/default-model-prices.json を編集する場合
• packages/shared/src/server/llm/types.ts を編集する場合
• 新しい価格設定対象モデルを追加する場合
• プロバイダーの価格、キャッシュ料金、またはティア条件を更新する場合
• Bedrock、Vertex、Azure、またはプロバイダーのプレフィックスが付いたモデル名に対する正規表現の対応範囲を拡張する場合
• 古い、欠落している、または一致しないプロバイダー価格がないか、デフォルトのモデル価格を監査する場合
• 新たにリリースされた主要モデルの公式プロバイダーのドキュメントを監査し、デフォルト価格や、該当する場合は選択可能なモデルへの追加が必要か確認する場合
• 選択可能なモデルのリストから、提供終了または廃止されたモデルを削除する場合

このスキルの読み方

• この SKILL.md は、全体的なワークフローとヘルパーの索引として使用します。
• タスクに合った特定のリファレンスファイルだけを開いてください。

クイックスタートチェックリスト

新しいモデルの追加

• プロバイダーのドキュメントから公式の価格情報を収集します。
• モデルのエントリー用に小文字の UUID を生成します。
• サポートするプロバイダー形式を網羅する matchPattern を作成します。
• デフォルトの価格ティアを少なくとも 1 つ追加します。
• すべてのトークン単価を <USD per MTok>e-6 の形式で記述します（1e-7 ではなく 0.1e-6）。
• サポートするすべての意味的な使用量バケットを、Langfuse が保存する可能性のあるプロバイダーのエイリアスに対応付けます。
• worker/src/constants/default-model-prices.json に価格エントリーを追加します。
• Playground または評価のワークフローでモデルを選択可能にする場合は、packages/shared/src/server/llm/types.ts を更新します。
• 編集後に JSON を検証します。

選択可能なモデルの提供終了

• プロバイダーの公式ライフサイクルページで、提供終了または廃止を確認します。
• packages/shared/src/server/llm/types.ts の選択可能なモデルの配列からモデルを削除し、モデルピッカーに表示されないようにします。
• 過去のコスト照会に備えて、default-model-prices.json のエントリーは保持します。
• 配列の順序は変更しないでください。最初の（デフォルトの）エントリーが提供終了になると、次のエントリーがデフォルトになります。

既存モデルの更新

• 該当する価格、キー、ティア、または正規表現を更新します。
• updatedAt を本日の ISO-8601 タイムスタンプに更新します。
• 編集後に JSON を検証します。

リファレンスマップ

トピック	次のような場合に参照してください	ファイル
スキーマとティアのルール	エントリの形式や料金ティアの不変条件が必要な場合	references/schema-and-tiers.md
プロバイダーの情報源と料金キー	公式料金 URL、トークンごとの換算、またはプロバイダー固有の使用量キーが必要な場合	references/provider-sources-and-price-keys.md
プロバイダー使用量キーマトリクス	OpenAI、Gemini、Anthropic、または Bedrock の使用量キーを追加または変更する場合	references/provider-usage-key-matrix.md
マッチパターン	matchPattern の正規表現またはプロバイダーの対応範囲を編集する場合	references/match-patterns.md
ワークフローと検証	エンドツーエンドの編集手順を実施する場合、またはよくあるミスを確認する場合	references/workflow-and-validation.md
自動監査モード	スケジュール済み／デフォルト料金の監査を実行し、CI に安全な編集ルールが必要な場合	references/automated-audit.md
監査メモリ	過去の有用な自動監査からモデルごとのコンテキストを任意で保持する場合	references/model-audit-memory.md

決定論的ヘルパー

• 料金ファイルバリデーター： node .agents/skills/add-model-price/scripts/validate-pricing-file.mjs
• マッチパターンテスター： node .agents/skills/add-model-price/scripts/test-match-pattern.mjs --model <modelName> --accept <sample...> --reject <sample...>
• 正規表現の直接テスター： node .agents/skills/add-model-price/scripts/test-match-pattern.mjs --pattern '(?i)^(openai/)?(gpt-4o)$' --accept gpt-4o openai/gpt-4o --reject gpt-4o-mini