fixing-metadata

使用する場面

このスキルは、ページタイトル、メタディスクリプション、canonical URL、Open Graph タグ、Twitter カード、favicon、JSON-LD 構造化データ、robots ディレクティブなど、HTML メタデータの監査と修正が必要な場合に使用します。SEO メタデータの追加、ソーシャル共有プレビューの修正、Open Graph タグのレビュー、canonical の設定などを行う場合に使用します...

ワークフロー

1. メタデータ（タイトル、説明、canonical、OG タグ）が欠落している、または正しくないページを特定する
2. 以下の優先度ルールに照らして監査する — 重大な問題（重複、インデックス登録）を最初に修正する
3. タイトル、説明、canonical、og:url がすべて互いに一致していることを確認する
4. ソーシャルカードが localhost ではなく実際の URL で正しく表示されることを検証する
5. 差分は最小限に留め、メタデータのみに範囲を限定する — 無関係なコードをリファクタリングしない

適用する場面

以下の場合にこれらのガイドラインを参照してください:

• ページタイトル、説明、canonical、robots を追加または変更する場合
• Open Graph または Twitter カードのメタデータを実装する場合
• favicon、アプリアイコン、manifest、theme-color を設定する場合
• 共有 SEO コンポーネントまたはレイアウトのメタデータデフォルトを構築する場合
• 構造化データ（JSON-LD）を追加する場合
• ロケール、代替言語、または canonical ルーティングを変更する場合
• ページ、マーケティングページ、共有可能なリンクをリリースする場合

優先度別のルールカテゴリ

priority	category	impact
1	correctness and duplication	critical
2	title and description	high
3	canonical and indexing	high
4	social cards	high
5	icons and manifest	medium
6	structured data	medium
7	locale and alternates	low-medium
8	tool boundaries	critical

クイックリファレンス

1. 正確性と重複 (critical)

• ページごとにメタデータを 1 か所で定義し、競合するシステムを避ける
• 重複する title、description、canonical、robots タグを出力しない
• メタデータは決定的でなければならず、ランダムまたは動的な値を使用しない
• ユーザー生成または動的な文字列は必ずエスケープおよびサニタイズする
• すべてのページに title と description の安全なデフォルト値を設定する

2. タイトルと説明 (high)

• すべてのページに title を設定する
• サイト全体で一貫したタイトル形式を使用する
• タイトルは短く読みやすく保ち、詰め込みを避ける
• 共有可能または検索可能なページにはメタディスクリプションを設定する
• 説明はプレーンテキストでなければならず、markdown や引用の乱用を避ける

3. canonical とインデックス登録 (high)

• canonical はページの優先 URL を指す必要がある
• noindex は非公開、重複、または非公開のページにのみ使用する
• robots meta は実際のアクセス意図と一致させる必要がある
• プレビューまたはステージングページは、可能な限りデフォルトで noindex にする
• ページネーションされたページは正しい canonical の動作を持つ必要がある

4. ソーシャルカード (high)

• 共有可能なページには Open Graph の title、description、image を設定する
• Open Graph および Twitter の画像は絶対 URL を使用する必要がある
• 正しい画像サイズと安定したアスペクト比を優先する
• og:url は canonical URL と一致させる必要がある
• 適切な og:type を使用し、通常は website または article とする
• twitter:card を適切に設定し、デフォルトでは summary_large_image とする

5. アイコンと manifest (medium)

• ブラウザ間で機能する favicon を少なくとも 1 つ含める
• 関連する場合は apple-touch-icon を含める
• manifest は有効でなければならず、使用時には参照する
• UI クロームの不一致を避けるため、theme-color を意図的に設定する
• アイコンのパスは安定してキャッシュ可能であるべきです

6. 構造化データ (medium)

• 実際のページコンテンツに明確に対応しない限り、JSON-LD を追加しない
• JSON-LD は有効でなければならず、実際にレンダリングされる内容を反映する必要がある
• 評価、レビュー、価格、組織の詳細を捏造しない
• 必要でない限り、ページごとに 1 つの構造化データブロックを優先する

7. ロケールと代替 (low-medium)

• html の lang 属性を正しく設定する
• ローカライズが存在する場合は og:locale を設定する
• ページが実際に存在する場合にのみ hreflang 代替を追加する
• ローカライズされたページはロケールごとに正しく canonical 化する必要がある

8. ツールの境界（重要）

• 最小限の変更を優先し、無関係なコードのリファクタリングは行わない
• 要望がない限り、フレームワークや SEO ライブラリの移行は行わない
• プロジェクト既存のメタデータパターン（Next.js metadata API、react-helmet、手動 head など）に従う

レビューのガイダンス

• まず重大な問題（重複、canonical、インデックス）を修正する
• title、description、canonical、og:url が一致していることを確認する
• ソーシャルカードは localhost ではなく実際の URL で検証する
• 巧妙または動的なメタデータよりも、安定した退屈なメタデータを優先する
• diff は最小限に保ち、メタデータのみにスコープを限定する

例

ユーザーのリクエスト:

ページタイトル、メタディスクリプション、canonical URL、Open Graph タグ、Twitter カード、favicon、JSON-LD 構造化データ、robots ディレクティブを含む HTML メタデータを監査して修正する。

制限事項

• このスキルは、タスクがその上流ソースおよびローカルプロジェクトのコンテキストに明確に一致する場合にのみ使用してください。
• 変更を適用する前に、コマンド、生成されたコード、依存関係、認証情報、外部サービスの動作を検証してください。
• 例を、環境固有のテスト、セキュリティレビュー、または破壊的もしくは高コストな操作に対するユーザーの承認の代わりとして扱わないでください。