technical-seo-schema-engineer

テクニカル SEO スキーマエンジニア

information-architecture-seo がページの役割を定義した後、ライブでの回帰検証を行う前にこのスキルを使用してください。

メタデータや JSON-LD のテンプレート全体を設計する前に、references/schema-patterns.md をお読みください。

担当範囲

• title と meta description のルール；
• canonical タグと hreflang タグのテンプレート；
• JSON-LD スキーマのパターン；
• OpenGraph と Twitter カードのメタデータ；
• sitemap、news-sitemap、RSS、robots.txt、llms.txt の出力ポリシー；
• パブリッシャーのロゴと ImageObject のフォールバックポリシー；
• ページタイプ別のメタデータチェックリスト。

担当範囲外

• セマンティックコア；
• 最終的な URL アーキテクチャ；
• 内部リンクのグラフ；
• ライブ監査の実行；
• 非表示コンテンツ；
• ページのビジュアルレイアウト。

ワークフロー

1. url-map.yaml、ページの役割、コンテンツモデル、言語グループ、表示コンテンツの要件を確認します。
2. ページの役割に応じてメタデータとスキーマを選択します。
3. title/meta のフォールバックと長さの目安を定義します。
4. URL マップに基づいて canonical タグと hreflang タグを定義します。
5. 表示されるページコンテンツに一致する JSON-LD ノードを定義します。
6. OG/Twitter 画像のポリシー（メディア、動画のポスター画像、パブリッシャーカード、フォールバック用 OG カード）を定義します。
7. sitemap/RSS/robots/llms.txt の掲載ルールを定義します。
8. assets/jsonld-templates.md と assets/head-metadata.template.html を使用して、スキーマと head のガイダンスを作成します。
9. 検証を seo-regression-validator に引き継ぎます。

必須事項

• スキーマは表示されるコンテンツと一致している必要があります。
• FAQ ブロックがユーザーに表示されない場合、FAQPage を追加しないでください。
• 存在しない、または裏付けのないレビュー、評価、価格、著者、パブリッシャー、日付、画像、出典に関する情報を追加しないでください。
• JSON-LD を使用して、追加のキーワード、エンティティ、別の事実を隠さないでください。
• NewsArticle.image はメディア、ポスター画像、または安定したフォールバック用 ImageObject を参照する必要があります。
• canonical と hreflang は URL アーキテクチャに従う必要があります。
• 本番環境に変更を加える前に、最新の Google/schema.org/クローラーのルールを一次情報で確認する必要があります。

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

• メタデータ、スキーマ、サイトマップ、RSS、robots、llms.txt に、管理者用情報、API、非公開ダッシュボード、生の分析データ、生の IP ログ、秘密ファイル、トークン、未公開の下書き、ステージング URL を公開しないでください。
• クロール可能にするために、認証、アクセス制御、CSP、CORS、Cookie、レート制限、非公開コンテンツの境界を弱めないでください。
• 公開 LLM 向けファイルに、非公開の指示や内部の計画メモを記載しないでください。
• robots.txt を、機密コンテンツを隠す手段として扱わないでください。
• セキュリティ、プライバシー、法的な正確性、アクセシビリティ、ユーザーが内容を理解できることは、SEO や LLM への露出を高める施策より優先されます。

検証

作業完了とする前に、次を確認してください。

• すべてのページタイプについて、title、description、canonical、OG、Twitter、スキーマのガイダンスがあること；
• すべてのスキーマタイプに、必要な表示コンテンツのフィールドがあること；
• すべてのニュース／記事ページに、画像のフォールバックポリシーがあること；
• すべての hreflang グループが、URL マップ上の対応関係に基づいていること；
• sitemap と news-sitemap のルールに、対象となる公開 canonical URL のみが含まれていること；
• robots と llms.txt のルールが、非公開／管理者用／API の領域を避けていること；
• 非表示のスキーマと重複した canonical のパターンが拒否されること。

スキルの変更は、次のコマンドで検証してください。

python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/technical-seo-schema-engineer
python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL

フォワードテストは evals.json にあります。

出力形式

次を返してください。

1. ページタイプ別のメタデータ一覧。
2. スキーマノードと必須の表示フィールド。
3. canonical/hreflang のルール。
4. sitemap/RSS/robots/llms.txt の掲載ポリシー。
5. 検証チェックリストと回帰検証担当者への引き継ぎ。