performance-monitor

パフォーマンスモニター

1つのモニタリングスキルに2つのモードがあります。report は、すでに発生した内容（トラフィック、ランキング、GEO／AI、権威性、バックリンク、コンテンツ）を複数の指標でまとめた、ステークホルダー向けのスナップショットを作成し、期間ごとの差分を優先順位付けされた推奨事項に変換します。alert は、今後のしきい値や異常を通知する設定を行い、ランキング、トラフィック、技術的健全性、バックリンク、競合他社の順位、AI からの引用が低下したときに、誰かが目視で確認する前に通知します。意図に応じてモードを選びます。過去についてのレポート → report、将来についての「発生したら知らせて」→ alert。

モード: report（複数指標のスナップショット） · alert（今後のしきい値／異常）。指定がない場合のデフォルト：動詞の時制から推定します（「判断ゲート」を参照）。

対象範囲の制限 — このスキルで行わないこと: CORE-EEAT コンテンツスコアの算出や、その拒否条件（T04/C01/R10）の実行は行いません。この判定は content-quality-auditor が担当します。CITE ドメインスコアの算出や、その拒否条件（T03/T05/T09）の実行も行いません。この判定は domain-authority-auditor が担当します。このスキルは、判定によってすでに算出されたスコアをレポートし、変化を監視しますが、スコアの算出は行いません。順位ごとの生のランキング差分は rank-tracker の担当です。

クイックスタート

# report mode
Create an SEO performance report for [domain] for [time period]
Generate an executive summary of SEO performance for [month/quarter]
Create a GEO visibility report for [domain]

# alert mode
Set up SEO monitoring alerts for [domain]
Create ranking drop alerts for my top 20 keywords
Alert me when AI citations for [domain] drop

最短の有効な呼び出し：performance-monitor <domain>（モードは推定されます）。出力：report は、すべての数値にソースタグを付けた「指標テーブル → 変化した内容 → 理由 → 次のアクション」のダッシュボードを返します。alert は、名前付きのトリガー、しきい値、優先度、通知先を含むアラート設定の概要を返します。どちらも memory/monitoring/ に保存できる引き継ぎ用の概要を出力します。

スキルの契約

想定される出力：モード report → 差分ベースの複数指標レポート／ダッシュボードと、変更ごとのサイクルレトロスペクティブ。モード alert → 即時の結果を宣言するのではなく、条件を指定した確認を開始するアラート設定の概要。どちらにも、ページ／変更／測定の正確な紐付け、エビデンス参照、memory/monitoring/ に保存できる標準の引き継ぎ用概要を含めます。

• 読み取るもの：過去のベースラインと現在のパフォーマンスデータ。report は、トラフィック／ランキング／権威性／コンテンツに関する現在と前期間の指標、レポート対象者、期間を読み取ります。alert は、ベースライン、監視する重要なキーワード／指標、通常の変動幅、通知の設定を読み取ります。ユーザー提供データやツールのデータも読み取ります。
• 書き込むもの：ユーザー向けのモニタリング成果物と、memory/monitoring/ に保存できる再利用可能な概要。
• 昇格するもの：重要な変化、確認済みの異常、継続的なしきい値、フォローアップのアクション。保留中の判断は memory/open-loops.md に記録します（decisions.md に直接記録することはありません）。
• 完了条件：
  • report：対象範囲の各セクション（トラフィック、ランキング、GEO、権威性、バックリンク、コンテンツ）が存在するか、「未評価」と記載されていること。すべての指標にソース、時点、期間、対象が紐付けられ、前期間または対照群と比較されていること。変化した各ページについて、現在のページ／コンテンツ／変更と、測定契約の参照／ハッシュが記録されていること。推奨事項に担当者、優先度、期待される影響が含まれていること。
  • alert：選択した各アラートカテゴリに、名前付きのトリガー、しきい値、優先度があること。Critical／High／Medium／Low に応じた対応計画と通知先が定義されていること。しきい値が、対象指標に記載された通常の変動幅に合わせて調整されていること。
• 主な次のスキル：次に推奨されるスキル を参照してください。2つのモードは互いに引き継ぎます。

引き継ぎ用の概要

skill-contract.md §Handoff Summary Format に定められた標準形式で出力します。「Objective」の行に、現在のモード（report ／ alert）を記載してください。

データソース

すべての連携は任意です（CONNECTORS.md を参照）。Tier 1（キー不要）はどちらのモードでも利用できます。キーが必要なツールは、オプトイン方式の Tier 2/3 です。

• report：ツールが接続されている場合は、~~analytics からのトラフィック、~~search console からの検索データ、~~SEO tool からのランキング／バックリンク、~~AI monitor からの AI での可視性を集計します。ツールがない場合は、分析データのエクスポート、Search Console のデータ、ランキングデータ、KPI をユーザーに求めてください。
• alert：ツールがある場合は、~~SEO tool、~~search console、~~web crawler からのリアルタイムフィードを監視します。ツールがない場合は、基準値、重要なキーワード、通知方法の希望、過去のデータをユーザーに求めてください。

依存関係ゼロの測定ループ（両方のモード）：報告する変更や発生したアラートはすべて、目視による推定ではなく、計算された差分に基づく必要があります。各期間の KPI を保存し、台帳で変化を計算します：python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/ledger.py" record <domain> --source monitor --data '{"sessions": ..., "clicks": ..., ...}' を実行し、続いて期間差分には ledger.py diff <domain> --source monitor、推移には ledger.py trend <domain> --source monitor --field <kpi> を実行します。すべての数値に「測定済み」「ユーザー提供」「推定」のラベルを付け、成果の変化は最新の変更ではなく、対照群に照らして評価してください。references/measurement-protocol.md を参照してください。scripts/connectors/README.md も参照してください。

判断ゲート

次の場合は停止してユーザーに確認してください：

• モードが曖昧 — リクエストが過去の実績について（「先月のレポートを作成して」）でも、今後の通知について（「X が下がったら知らせて」）でもない場合。（1）今すぐ report でスナップショットを作成する、（2）継続的な監視に alert を使う、（3）両方、の選択肢を提示してください。
• report：報告期間も比較期間も特定できず、文脈にも含まれていない場合は、（1）直近30日間とその前の30日間、（2）直近の暦月とその前の月、（3）カスタム期間、の選択肢を提示してください。期間比較は必須であり、任意ではありません。
• alert：監視対象の指標に基準値や通常の変動範囲を示す情報がない場合 — しきい値を恣意的に設定することになります。（1）最近の基準データを提供する、（2）Alert Threshold Quick Reference の既定値を使い、「推定」と明記する、（3）キャンセルする、の選択肢を提示してください。

そのまま続行する（次の理由では決して停止しない）：

• レポートのセクションのソースデータがない — そのセクションを「未評価」とし、指標を捏造せずに続行してください。
• 対象読者が指定されていない（report） — エグゼクティブ向けテンプレートを既定値として使い、その前提を明記してください。
• 通知チャネルが指定されていない（alert） — 文脈にあるチャネル（またはメール）を既定値として使い、その旨を記してください。
• ユーザーが言及していないアラートカテゴリ — 未設定のままにし、依頼されていないアラートを追加しないでください。

手順

ステップ 0 — モードを選択します。 指定されていれば --mode を読み取ります。それ以外の場合は、過去形／「どうだったか」／「月報」なら report、未来形／「知らせて」／「予警」なら alert と推測します。どちらにも当てはまらない場合は、上記のモードが曖昧な場合の判断ゲートに従ってください。

モード：report

レポート出力テンプレートを使用し、以下を網羅します。

1. レポートパラメーターの定義 — ドメイン、期間、比較期間、レポートの種類、対象読者、重点分野、データの鮮度。
2. エグゼクティブサマリー — 総合評価、成果、注意事項、必要な対応、主要指標（トラフィック、ランキング、コンバージョン、DA／オーソリティ、AI による引用）、SEO の投資収益率。各指標に「Measured」「User-provided」「Estimated」のいずれかを付けます。
3. オーガニックトラフィック — セッション数、ユーザー数、ページビュー数、エンゲージメント／直帰、推移、流入元／デバイス別内訳、上位ページ。各数値にデータソースを示すタグを付けます。
4. キーワードランキング — 順位範囲、分布の変化、順位が大きく上がった／下がったキーワード、SERP の機能。順位ごとの生の変動値については、ここで再計算せず、rank-trackerに委ねます。
5. GEO／AI パフォーマンス — AI による引用の概要、トピック別の引用、GEO の成果、最適化の機会。
6. ドメインオーソリティ（CITE） — ゲートで既に算出されている場合は、CITE の各ディメンションのスコアと拒否ステータスを含めます。そうでない場合は「Not yet evaluated」と記載します。ここでは CITE を算出しないでください。
7. コンテンツ品質（CORE-EEAT） — 平均スコアと推移が既に算出されている場合は含めます。そうでない場合は「Not yet evaluated」と記載します。ここでは CORE-EEAT を算出しないでください。
8. バックリンク — リンクプロファイルの概要、獲得推移、注目すべきリンク、競争上の位置付け。
9. コンテンツのパフォーマンス — 公開状況の概要、上位コンテンツ、注意が必要なコンテンツ、コンテンツの ROI。
10. 推奨事項 — 優先度、担当者、期待される効果、次の期間の目標を含む、即時／短期／長期のアクション。
11. レポート全体の作成 — 目次、付録、データソース、方法論、用語集。

モード：alert

アラート設定テンプレートを使用し、以下を行います。

1. アラートカテゴリの定義 — ランキング、トラフィック、技術、バックリンク、競合他社、GEO／AI、ブランドから選択します。
2. カテゴリ別のアラートルール設定 — 該当する各ルールについて、トリガー条件、しきい値、アラート名、優先度を定義します。各しきい値を明示されたベースラインと結び付け、そのベースラインに「Measured」「User-provided」「Estimated」のいずれかを付けます。
3. アラート対応計画の定義 — Critical／High／Medium／Low を対応時間と次のアクションに対応付けます。
4. アラート配信の設定 — チャネル、ルーティング、クールダウン、メンテナンス時間、エスカレーション経路を設定します。
5. アラートサマリーの作成 — カテゴリ別の件数、重大アラート用のプレイブック、週次レビューのチェックリストを成果物として出力します。

共通の原則（両モード）

すべての指標に Measured（ツール／エクスポートデータ）、User-provided、または Estimated（モデルによる推論）のいずれかを付けます。推定値を実測値として提示してはいけません。必要な指標を入手できない場合は N/A と記載し、値を捏造してはいけません。観測された変化と妥当な説明（原因として述べる前に裏付けを取る）、最適化の機会、およびクロール／SERP／ランキング／監査が必要なフォローアップを区別します。未検証の説明を確認済みの原因として報告してはいけません。

アラートしきい値のクイックリファレンス

指標	警告	重大	頻度
オーガニックトラフィック	前週比 -15%	前週比 -30%	毎日
キーワード順位	3 順位超の下落	5 順位超の下落	毎日
インデックス登録済みページ	-5% の変化	-20% の変化	毎週
クロールエラー	1 日あたり新規 10 件超	1 日あたり新規 50 件超	毎日
Core Web Vitals	「改善が必要」	「不良」	毎週
失われたバックリンク	1 週間で 5% 超	1 週間で 15% 超	毎週
AI による引用の減少	重要なクエリで 1 件でも発生	クエリの 20% 超	毎週
セキュリティの問題	1 件でも検出	1 件でも検出	毎日

急落トリガー（常時有効）： オーガニックトラフィックまたはキーワード順位の集計値が、直近のベースライン（デフォルト：同じ曜日区分における過去 28 日間の中央値）を 30% 超下回った場合、カテゴリにかかわらず Critical アラートを発報します。単日のノイズで発報しないよう、直前日の値ではなく移動中央値を使用します。ベースラインに「Measured」「User-provided」「Estimated」のいずれかを付けます。

コントロールと比較した差分の読み取り

報告された差分や発火したアラートは、変更前に設定した固定の読み戻し期間でコントロールを上回った場合にのみ、証拠となります。交絡要因のある結果を単純に変更前後で比べても、それは物語であって証明ではありません。references/measurement-protocol.md §Cross-discipline decision protocol の意思決定プロトコルを適用してください。

まず、SEO/GEO Evidence and Cycle Control Profile を適用します。読み戻しでは、現在のフォークされていないページ／コンテンツ／変更のヘッドと、正確な測定契約のハッシュを紐付ける必要があります。その後の編集によって以前の紐付けは無効になり、新しい期間が始まります。事後に設定された期間には、明示的に reconstructed と記録します。

• 読み戻し期間 — 変更の種類に応じた期間を事前に選び（コンテンツの更新は7／14／28／56日、新規コンテンツは14／28／56／90日、技術的な修正は毎日×7日、その後28日、AEO/GEOでの露出は毎週）、期間中のノイズには反応しないでください。アラートが発火したら、即時に判断するのではなく、読み戻し期間を開始します。インシデントと宣言する前に、下落が続いていることを確認してください。
• 読み戻しに必要なフィールド — 次の項目を記録します：ページ／コンテンツ／変更の参照情報とハッシュ · 現在のヘッド · 測定契約の参照情報／ハッシュ · 担当者 · ベースライン／候補／コントロールの各期間 · 証拠の参照情報 · 主指標と副指標 · 判断 · 留意事項 · 次のパッチ · 次回の読み戻し日 · 該当するインデックス受領記録。
• 判断 — 各変更を Promote（主指標で基準を超えてコントロールを上回る）、Keep-testing（上昇傾向にあるが、まだ有意ではない）、Rollback（同じ基準で劣る）、または Unproven（それ以外）のいずれかに分類します。単純な差分ではなく、コントロールとの差分を報告してください。

例

• report：全体的なステータス、トラフィック／ランキング／コンバージョン／オーソリティ／AI による引用の主要指標の一覧、SEO ROI、担当者と日付を含む即時／月次／四半期のアクションをまとめたエグゼクティブサマリーです。
• alert：Critical と High のしきい値、下落時の対応計画、メールと Slack への通知振り分けを記載したキーワードアラートのマトリクスです。

結果の保存

「これらの結果を保存しますか？」と尋ねます。はいの場合は、ファイル名を YYYY-MM-DD-<topic>.md として memory/monitoring/ に書き込みます。skill-contract.md §Save Results Template を参照してください。このスキルは非監査スキルです。メモリーに書き込む前に確認し、拒否権に関わるリスクは拒否マーカーを自ら追記するのではなく、該当する監査ゲートに引き継いでください。

参考資料

• Report Output Templates — 11のレポートセクションすべてに対応する、簡潔なスターターブロック（report モード）
• KPI Definitions — ベンチマーク、しきい値、傾向分析、アトリビューションのガイダンスを含む SEO/GEO 指標の定義
• Report Templates by Audience — 経営層、マーケティング、技術、クライアント向けの、すぐに使えるテンプレート
• Alert Configuration Templates — 全カテゴリの表、しきい値、対応計画のテンプレート（alert モード）
• Alert Threshold Guide — しきい値の設定、アラート疲れの防止、エスカレーション経路、対応プレイブック
• Measurement & Attribution Protocol — 読み戻し期間、必須フィールド、Promote／Keep-testing／Rollback／Unproven の判断ルール
• SEO/GEO Evidence and Cycle Control Profile — 検索／ページの紐付け、インデックス受領記録、鮮度、Cycle Retro フィールド

次に実行するスキル

モードに応じて選択し、その後は終了します。

• レポートの後 — 変更の継続的な監視が必要な場合 → このスキルをalertモードで実行します。権威性について「未評価」と記されたセクションがある場合 → domain-authority-auditor、コンテンツ品質についての場合 → content-quality-auditor。対応不要の単発レポート → 終了します。
• アラートの後 — レポートの実施間隔が指定されている場合 → このスキルをreportモードで実行します。単独でのアラート設定 → 終了します。

終了条件：skill-contract.md §Termination rulesの訪問済みセットとmax-depth: 3のルールが適用されます。この連鎖ですでに実行したモードには再度入りません（report→alert→reportは訪問済みセットによる停止となります）。振り分けが曖昧な場合は、選択肢を提示して停止し、自動的に続行しないでください。