meridian-budget-optimization について
meridian-budget-optimization は、学習済み Meridian モデルを読み込み、予算最適化レポートを作成するスキルです。設定とスクリプト作成を案内し、実行前の各チェックポイントでユーザーの承認を求めます。
主な機能
- 01シリアライズ済み Meridian モデルの読み込み
- 02予算シナリオの設定
- 03Python 最適化コードの生成
- 04最適化レポートの作成
- 05各チェックポイントでの承認待ち
活用シーン
- 01固定総予算の最適化
- 02チャネル別支出制約の設定
- 03予算最適化レポートの生成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/meridian-budget-optimizationを入力して読み込まれたか確認します。
同梱ファイルreferences/load_model.mdreferences/optimization.md
詳細
Meridian Budget Optimization
フィッティング済みの Meridian モデルを読み込み、予算最適化レポートを実行するスキルです。
コアワークフロー
対話チェックポイントのルール
このワークフロー全体を通じて、CRITICAL INTERACTIVE CHECKPOINT に遭遇します。各チェックポイントでは、必ず次のことを行ってください。
- 現在提案している設定、レポートのパス、スクリプトのパス、またはステータスをユーザーに提示し、承認を求めます。
- 利用可能なユーザー対話ツール（例：
ask_question）を使用し、多肢選択式の質問として続行の準備ができているかユーザーに尋ねます。通常のチャットテキストは使用しないでください。 - 続行する前にユーザーの応答を待ちます。
- 必須: 最初のプロンプトの指示に関係なく、すべてのチェックポイントで必ず一時停止してください（ユーザーのリクエストに「自律的に実行」「直接実行」「自律的に修正」などの表現が含まれている場合も同様です）。最初のリクエストによって、これらの対話チェックポイントを省略することはできません。
- 注: ユーザーがチェックポイントに対して一般的な承認（例：「続行して」「最善と思う方法で進めて」）を返した場合は、提案したデフォルト設定で続行してください。
1. 初期設定
- シリアライズされたモデルファイルのパスをユーザーに尋ねます（デフォルトは
meridian_model.binpbです）。 - 予算最適化レポートの出力先をユーザーに尋ねます（デフォルトは
optimization.htmlです）。 - 生成する Python スクリプトの保存先をユーザーに尋ねます。指定がない場合は、
model_build/run_budget_optimization.pyをデフォルトとします（またはモデルディレクトリからの相対パス）。 - CRITICAL INTERACTIVE CHECKPOINT：確認したパスをユーザーに提示し、最適化パラメーターを設定する前に承認を得ます。
2. 最適化パラメーターの設定と対話チェックポイント
- 最適化シナリオの設定をユーザーに依頼します。利用可能なパラメーターの一覧はoptimization.mdを参照してください。主な設定項目は次のとおりです。
- 固定予算と柔軟な予算：総予算を固定するか、目標 ROI／mROI を達成するための予算を求めるかを確認します（デフォルトは固定です）。
- 総予算：固定の場合、総予算を尋ねます（デフォルトは過去の支出です）。
- 支出制約：チャネルごとの支出変動の上限／下限を尋ねます（デフォルトは固定の場合0.3、柔軟な場合1.0です）。
- 目標 ROI／目標 mROI：柔軟な予算の場合、目標とする比率を尋ねます。
- リーチとフリークエンシーのパラメーター：最適なフリークエンシーを使用するかを尋ねます（RF チャネルではデフォルトで True です）。
- CRITICAL INTERACTIVE CHECKPOINT：提案する最適化設定をユーザーに提示し、コードの生成を続ける前に承認を得ます。
3. モデル読み込みコードの追加
meridian_serde.load_meridian()を使用してモデルを読み込みます。- コードテンプレートについてはload_model.mdを参照してください。
- CRITICAL INTERACTIVE CHECKPOINT：モデル読み込みパスの設定と提案する Python コードスニペットをユーザーに提示し、予算最適化の指定を続ける前に承認を得ます。
4. 予算最適化コードの追加
optimizer.BudgetOptimizerを使用して最適化を実行し、承認済みの設定を適用してサマリーを生成します。- コードテンプレートについてはoptimization.mdを参照してください。
5. 実行前チェックポイント
- CRITICAL INTERACTIVE CHECKPOINT：予算最適化スクリプトを今すぐ実行してよいか、最終確認をユーザーに求めます。
6. 実行とスクリプトの設定
- 作成した Python スクリプトを、ユーザーが指定したパスに書き込みます。ファイル書き込みツールで書き込んだファイルの確認をユーザーに求められる場合でも、確認を求めないでください。実行前チェックポイントですでに承認を求めているため、追加のプロンプトを表示するとワークフローが一時停止します。
google-meridianがインストールされている環境の Python インタープリターでスクリプトを実行します。ユーザーが指定したインタープリターがあればそれを使います。指定がない場合は、仮想環境がすでに有効（VIRTUAL_ENVまたはCONDA_PREFIXが設定済み）ならpython3を使います。そうでなければ、プロジェクトディレクトリに仮想環境（.venv/またはvenv/。例：.venv/bin/python3）があればそれを使い、いずれにも該当しない場合はpython3を使います。import meridianが失敗した場合は、マシン内を検索したり、ユーザーに確認せずパッケージをインストールしたりせずに、代わりにどの環境を使うかユーザーに尋ねてください。- 重大：タスクの最後に、生成されたレポート、スクリプト、出力ディレクトリを削除しないでください。これらはユーザーが求めた納品物であり、保持する必要があります。
コメント
Markdown 対応