autopilot-status

/digital-marketing-pro:autopilot-status

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定しない場合、スクリプトはこのプラグインの skills/ と同じ階層にある scripts/ フォルダーにあります。Python 3.10 以降で実行してください。python が見つからない場合は、python3 を使用してください（macOS、多くの Linux システム）。

目的

キャンペーン運用オートパイロットのダッシュボードです。すべてのアクティブなキャンペーンの健全性スコアを表示し、最近実施された自動修正を一覧表示して、現在のガードレール設定を表示し、人による対応が必要なキャンペーンにフラグを立て、自動介入による節約額を報告します。オートパイロットシステムがキャンペーンの健全性をどのように管理しているかを一画面で把握できるため、順調に稼働しているものを信頼し、対応が必要なものに集中し、自動監視の価値を定量化できます。

必要な入力

ユーザーは次の情報を指定する必要があります（指定がない場合は入力を求められます）。

• 期間：修正履歴と節約額の計算に使用する遡及期間です。デフォルトは「過去24時間」です。「過去1時間」「過去12時間」「過去24時間」「過去7日間」「過去30日間」、または任意の日付範囲を指定できます。リアルタイムの運用確認には短い期間、パフォーマンスレビューやレポートには長い期間を使用します
• キャンペーンフィルター（任意）：名前、ID、チャネル、またはステータスでキャンペーンを絞り込みます。例：「第1四半期のブランド認知キャンペーンのみ」「すべての Google Ads キャンペーン」「campaign-id-12345」。省略すると、すべてのチャネルのアクティブなキャンペーンが表示されます
• 詳細レベル（任意）：summary（デフォルト。健全性スコア、修正件数、節約額の概要）または detailed（修正ログの全件、修正前後の指標、ガードレールルールの説明、キャンペーンごとの節約額の内訳）。日々の確認には summary、週次レビューやトラブルシューティングには detailed を使用します

プロセス

1. ブランドコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み込み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランド固有のキャンペーン命名規則、KPI 目標、予算の制約を適用し、ヘルススコアと節約額の計算に反映します。~/.claude-marketing/sops/ に代理店の SOP がないか確認します。ブランドが存在しない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で続行します。
2. キャンペーンのヘルススコアを収集する：アクティブな各キャンペーン（またはフィルターで絞り込んだキャンペーン）について、python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-health-monitor.py" --brand {slug} --action health-score --campaign-id {id} --metrics '{...campaign metrics...}' を実行します。各キャンペーンには、KPI 目標に対するパフォーマンス、予算消化ペースの正確性、オーディエンスへのリーチ、クリエイティブの疲弊を示す指標、異常検知に基づく総合ヘルススコア（0～100）が付与されます。キャンペーンは、健全（80～100）、要注意（50～79）、危険（50 未満）に分類されます。
3. 最近の自動修正を取得する：指定期間について、python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-health-monitor.py" --brand {slug} --action corrections-history --since {YYYY-MM-DD} を実行します。各修正記録には、対象のキャンペーン、検出内容（トリガー条件）、実行したアクション（入札額の調整、予算の再配分、オーディエンスの変更、クリエイティブのローテーション、一時停止）、修正前後の指標値、介入のタイムスタンプが含まれます。
4. 現在のガードレール設定を読み込む：アクティブなガードレールのルール（予算乖離率の上限、一時停止前の ROAS 最低しきい値、クリック率の下限、顧客獲得単価の上限、フリークエンシーキャップの上限、クリエイティブの疲弊によるローテーションのトリガー、ブランド固有のカスタムルールなど）を読み込みます。アクティブなガードレール、それぞれのしきい値、しきい値を超えた場合に実行される自動アクションを表示します。
5. 人による対応が必要なキャンペーンを特定する：ヘルススコアが要注意のしきい値を下回っているキャンペーン、ガードレールによる自動修正の範囲を超える問題があるキャンペーン（例：戦略の転換が必要、クリエイティブの刷新が必要、オーディエンスの飽和を検知、または自動運用の権限を超える予算の再配分が必要）、あるいは自動運用による修正後、想定期間内に指標が回復していないキャンペーンにフラグを付けます。フラグを付けたキャンペーンを緊急度順に並べます。
6. 自動修正による節約額を計算する：指定期間について、python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-health-monitor.py" --brand {slug} --action savings-report --since {YYYY-MM-DD} を実行します。パフォーマンスの低いセグメントの一時停止による予算の節約、異常の早期検知による収益の保護、自動入札額調整による効率向上など、各自動修正で未然に防いだ無駄を推定します。推定節約額を合計し、修正ごとの内訳も示します。

出力

• キャンペーン健全性ダッシュボード：すべてのアクティブなキャンペーン（またはフィルタリングされたキャンペーンの一覧）について、健全性スコア（0～100）、リスク分類（健全、要注意、重大）、スコアに影響する主な要因、前の期間と比較した傾向の指標（改善、安定、低下）を表示します
• 実施した自動修正：期間中に実施された自動介入を時系列順に一覧表示します。キャンペーン名、トリガー条件、実施したアクション、実施前後の指標、推定される影響を含みます。修正タイプ（入札、予算、オーディエンス、クリエイティブ、一時停止）ごとに分類し、各カテゴリの件数も表示します
• 対応が必要なキャンペーン：人による確認が必要なキャンペーンを優先度順に一覧表示します。それぞれについて、具体的な問題、自動運転の権限を超える理由、推奨アクション、緊急度を示します。これらはユーザーの判断が必要な項目です
• ガードレールのステータス：現在のガードレール設定をルール表で表示します。ルール名、しきい値、違反時の自動アクション、ステータス（有効または一時停止）、期間中にトリガーされた回数を含みます
• 節約レポート：自動介入によって防止できた無駄な支出の推定合計を表示し、修正タイプ別に分類します。該当する場合はキャンペーンごとの内訳も示します。節約した予算、保護された収益、効率の改善を、実数とパーセンテージの両方で示します
• 全体的な運用健全性スコア：自動運転システムの有効性を表す単一の総合スコア（0～100）です。キャンペーンの健全性の分布、修正の成功率、未解決の問題、ガードレールの適用範囲を考慮します。前の期間と比較した傾向も示します

使用するエージェント

• performance-monitor-agent — KPI のパフォーマンス、予算消化の進捗、オーディエンスへの配信、クリエイティブの疲弊度を組み合わせた指標によるキャンペーン健全性のスコアリング、異常検出と深刻度に基づく問題の分類、自動修正履歴の取得と実施前後の影響分析、各介入で防止できた無駄な支出の推定による節約額の算出、現在の健全性と前の期間の比較による傾向分析
• execution-coordinator — ルールのステータスとしきい値の表示を含むガードレール設定の管理、自動運転で対応できる事項と人の判断が必要な事項の権限レベル分類を含む修正実行の追跡、緊急度の順位付けと推奨アクションを含む人による対応が必要なキャンペーンのフラグ付け、自動運転システム全体の運用健全性スコアリング