seo-regression-validator

SEO 回帰バリデーター

技術的な SEO／スキーマのガイダンスが整った後、サイトやスキルの出力が完成したと宣言する前に、このスキルを使用します。

広範な監査を実行する前に、references/regression-checklist.md を読んでください。

担当範囲

• ライブ HTML とローカルフィクスチャのチェック；
• 合否の重大度モデル；
• タイムスタンプ付きのエビデンスレポート；
• スキーマ／head メタデータのチェック；
• 公開アーティファクトへの到達性チェック；
• 回帰レポートのテンプレート；
• JSON-LD の欠落、canonical の重複、画像の欠落、偽のレポートに対するネガティブテスト。

対象外

• SEO 修正の実装；
• Search Console の認証情報を使ったデータ；
• アナリティクスのエクスポート；
• 外部サイトでの権威性向上；
• 対象ウェブサイトの変更。

ワークフロー

1. 対象 URL またはフィクスチャファイルを定義します。
2. タイムスタンプ、対象、方法、ユーザーエージェントを記録します。
3. 対象を変更せずに取得または読み込みます。
4. HTML がある場合は、scripts/audit_static_seo.py を使って決定論的なチェックを実行します。
5. 重大な失敗、警告、スキップしたチェックを分けます。
6. スキップしたチェックは合格として扱わず、記録します。
7. seo-regression-report.json と人が読める検証概要を作成または更新します。
8. 実装修正を適切な専門担当者に引き継ぎます。

デフォルトで重大とする項目

• <title> の欠落；
• meta description の欠落；
• canonical の欠落または重複；
• スキーマが想定されるページに JSON-LD がない；
• JSON-LD が無効；
• NewsArticle に使用可能な画像がない；
• ライブチェック中に公開ページがブロックされている、または到達できない；
• 対象を取得または読み込まずに、レポートが成功を主張している。

デフォルトで警告とする項目

• 多言語の相当ページが想定される場合に hreflang がない；
• OG／Twitter のソーシャルタグがない；
• RSS の自動検出がない；
• viewport がない；
• Article スキーマがある場合に article のメタタグがない；
• BreadcrumbList が想定される場合に、表示されるパンくずリストがない；
• パフォーマンス指標が測定されていない。

安全性とプライバシーの境界

• 対象サイトを変更しないでください。
• ユーザーがこのタスクのために明示的に提供した場合を除き、認証情報を使用しないでください。
• Cookie、トークン、未加工の非公開アナリティクス、未加工の IP ログ、非公開の Search Console 行データをレポートに保存しないでください。
• 1 回の HTML チェックから、ランキング、インデックス登録、引用、クローラーの動作について断定しないでください。

検証

スキルの編集内容を次の方法で検証します。

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/seo-regression-validator
python3 $HOME/SKILL/skills/seo-regression-validator/scripts/audit_static_seo.py $HOME/SKILL/skills/seo-regression-validator/fixtures/good-news.html
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

後続テストは evals.json にあります。

出力形式

次の内容を返します。

1. チェックした対象。
2. 重大な指摘事項。
3. 警告。
4. スキップしたチェック。
5. エビデンスのパスまたは URL。
6. 各修正の実装担当者。