fixing-metadata
正しく完全なメタデータを提供します。
使用方法
-
/fixing-metadataこの会話内のメタデータ関連の作業に、以下の制約を適用します。 -
/fixing-metadata <ファイル>指定されたファイルを以下のすべてのルールに照らしてレビューし、以下を報告します:- 違反箇所(該当する行またはスニペットを引用)
- なぜそれが重要なのか(簡潔な一文)
- 具体的な修正方法(コードレベルでの提案)
特に要求がない限り、新しいフレームワークやSEOライブラリを導入しないでください。最小限の差分を推奨します。
適用タイミング
以下の状況でこれらのガイドラインを参照してください:
- ページのタイトル、説明、canonical、robotsを追加または変更する場合
- Open GraphやTwitterカードのメタデータを実装する場合
- ファビコン、アプリアイコン、マニフェスト、theme-colorを設定する場合
- 共有SEOコンポーネントやレイアウトメタデータのデフォルトを構築する場合
- 構造化データ(JSON-LD)を追加する場合
- ロケール、代替言語、canonicalルーティングを変更する場合
- 新しいページ、マーケティングページ、共有可能なリンクを公開する場合
ルールカテゴリ(優先度順)
| 優先度 | カテゴリ | 影響 |
|---|---|---|
| 1 | 正確性と重複 | 重大 |
| 2 | タイトルと説明 | 高 |
| 3 | canonicalとインデックス | 高 |
| 4 | ソーシャルカード | 高 |
| 5 | アイコンとマニフェスト | 中 |
| 6 | 構造化データ | 中 |
| 7 | ロケールと代替ページ | 低〜中 |
| 8 | ツールの境界 | 重大 |
クイックリファレンス
1. 正確性と重複(重大)
- メタデータはページごとに1箇所で定義し、競合するシステムを避けてください
- タイトル、説明、canonical、robotsタグを重複して出力しないでください
- メタデータは決定論的である必要があり、ランダムまたは不安定な値は避けてください
- ユーザー生成または動的文字列はエスケープおよびサニタイズしてください
- すべてのページにタイトルと説明の安全なデフォルトが設定されている必要があります
2. タイトルと説明(高)
- すべてのページにタイトルが必要です
- サイト全体で一貫したタイトル形式を使用してください
- タイトルは短く読みやすく保ち、過剰なキーワード詰め込みを避けてください
- 共有可能または検索可能なページにはメタ説明が必要です
- 説明はプレーンテキストで、マークダウンや引用の多用は避けてください
3. canonicalとインデックス(高)
- canonicalはページの優先URLを指す必要があります
- noindexはプライベート、重複、または非公開ページにのみ使用してください
- robotsメタは実際のアクセス意図と一致している必要があります
- プレビューやステージングページは、可能な場合デフォルトでnoindexに設定してください
- ページネーションされたページは正しいcanonical動作を持つ必要があります
4. ソーシャルカード(高)
- 共有可能なページにはOpen Graphのタイトル、説明、画像を設定してください
- Open GraphとTwitterの画像は絶対URLを使用してください
- 適切な画像サイズと安定したアスペクト比を推奨します
- og:urlはcanonical URLと一致する必要があります
- 適切なog:type(通常はwebsiteまたはarticle)を使用してください
- twitter:cardを適切に設定し、デフォルトはsummary_large_imageにしてください
5. アイコンとマニフェスト(中)
- クロスブラウザで動作するファビコンを少なくとも1つ含めてください
- 必要に応じてapple-touch-iconを含めてください
- マニフェストは使用時に有効で参照されている必要があります
- theme-colorは意図的に設定し、UIクロームの不一致を避けてください
- アイコンパスは安定しておりキャッシュ可能である必要があります
6. 構造化データ(中)
- JSON-LDは、実際のページコンテンツに明確にマッピングされる場合のみ追加してください
- JSON-LDは有効であり、実際にレンダリングされる内容を反映している必要があります
- 評価、レビュー、価格、組織の詳細を捏造しないでください
- 特に必要がない限り、ページごとに1つの構造化データブロックを推奨します
7. ロケールと代替ページ(低〜中)
- html lang属性を正しく設定してください
- ローカライゼーションが存在する場合はog:localeを設定してください
- hreflangの代替ページは、ページが実際に存在する場合のみ追加してください
- ローカライズされたページはロケールごとに正しくcanonical化されている必要があります
8. ツールの境界(重大)
- 最小限の変更を推奨し、無関係なコードのリファクタリングは行わないでください
- 要求がない限り、フレームワークやSEOライブラリの移行は行わないでください
- プロジェクトの既存のメタデータパターン(Next.js Metadata API、react-helmet、手動のheadなど)に従ってください
レビューガイダンス
- 重大な問題(重複、canonical、インデックス)から修正してください
- タイトル、説明、canonical、og:urlが一致していることを確認してください
- ソーシャルカードはlocalhostではなく実際のURLで検証してください
- 賢く動的なメタデータよりも、安定した堅実なメタデータを推奨します
- 差分は最小限に抑え、メタデータのみに範囲を限定してください