site-architecture

site-architecture スキルの概要

site-architecture は何のためのものか

site-architecture スキルは、検索エンジンや AI クローラーが実際に見つけて理解できる技術基盤を設計・監査するのに役立ちます。robots.txt、サイトマップ、メタタグ、クロール許可、Core Web Vitals など、実務的なサイト構造の判断にフォーカスしているため、可視性がコンテンツ品質だけでは決まらない場面で特に有効です。

こんな人・こんな仕事に向いている

新規サイトを立ち上げるとき、インデックスの問題を修正したいとき、あるいはコンテンツ量の多いサイトを SEO のために整えたいときは、site-architecture skill を使うとよいでしょう。特に、開発者、SEO リード、編集者のように、一般論ではなく明確な技術方針が必要な人に向いています。

何が違うのか

このスキルは、単なる「SEO」プロンプトではありません。GPTBot、ClaudeBot、PerplexityBot のような従来の検索エンジンと AI クローラーの両方に対する発見性を重視し、Open Graph や Twitter Cards を通じたソーシャルプレビューにも触れます。要するに、アーキテクチャ上の判断を、クロール可能でインデックス可能なページへ落とし込み、目に見えない障害を減らすことが主な価値です。

向いているケース・向いていないケース

サイト全体の構造、クロール許可、メタデータの整合性が課題なら、かなり相性がよいスキルです。一方で、単発の meta description、1本のコンテンツブリーフ、あるいは技術的な公開層を伴わないデザインフィードバックだけが必要なら、優先度は低めです。

site-architecture スキルの使い方

インストールして、正しいファイルを開く

site-architecture install を使うときは、監査または設定したいサイトと同じワークスペースでスキルを使い、まず SKILL.md を開いてください。この repo は意図的に軽量で、最も価値の高い指針はそのファイルに集約されています。補助スクリプトやヘルパーフォルダは用意されていないため、ルールを丁寧に読み、自分のスタックに当てはめる前提で使う必要があります。

スキルに渡すべき情報

site-architecture usage のパターンは、サイト種別、プラットフォーム、現在の制約を与えると最も効果的です。たとえば、「Next.js で動くマーケティングサイトのクロール性、sitemap の網羅性、AI bot へのアクセスを監査してほしい。公開ページのみインデックス対象にしたい」といった入力です。これだけで、漠然としたベストプラクティスではなく、実際に使える技術提案を引き出しやすくなります。

より良い出力を引き出す聞き方

site-architecture guide はチェックリストではなく、ワークフローとして使うのがコツです。たとえば、次のいずれかの成果物を指定して依頼してください。

• 特定環境向けの robots.txt の下書き
• 公開 URL と非公開 URL を分ける sitemap 方針
• テンプレートやページ種別ごとのメタデータルール
• 現在のサイト構造に対するクロール / インデックス監査

site-architecture for SEO Content が必要なら、重要なコンテンツページ、生成方法、検索に出したくないページを具体的に伝えてください。そうすることで、可視性と除外のバランス、つまり本質的なアーキテクチャ上のトレードオフを適切に扱えます。

まず読むファイル

まず次を開いてください。

• skills/site-architecture/SKILL.md

そのあと、自分の repo の中で次のパスに該当するものがあれば確認します。

• robots.txt
• sitemap.xml または sitemap 生成処理
• HTML テンプレート
• public アセット用ディレクトリ

この skill repo 自体には追加の支援ファイルがないため、実装品質は、スキルのルールを実際のサイト構造へどう対応づけるかにかかっています。

site-architecture スキル FAQ

site-architecture は開発者専用ですか？

いいえ。site-architecture skill は SEO 担当、コンテンツチーム、サイトオーナーにも役立ちますが、最終的な変更を入れるのは開発者であることが多いです。非開発者でも、コード変更の前にクロールとインデックスの方針を固めることで十分な価値があります。

普通のプロンプトと何が違いますか？

普通のプロンプトは「SEO のベストプラクティス」を尋ねがちで、出力が一般論になりやすいです。site-architecture は範囲がより狭く、クロール許可、発見性、メタデータ、技術的制約に焦点を当てます。そのため、コピー案ではなく、インデックスに影響する判断が必要な場面で向いています。

初心者でも使えますか？

はい。サイトを明確に説明できるなら使いやすいです。技術的な課題に構造を与えてくれるという意味で初心者向きですが、プラットフォーム、公開 / 非公開 URL のルール、インデックス対象にするかどうかといった基本情報は必要です。

どんなときに使わないほうがいいですか？

ホームページ文案の作成や商品名の検討のように、純粋にクリエイティブな作業では site-architecture は使わないでください。また、クロールやインデックスの懸念がないサイトなら、このスキルのアーキテクチャ指針は不要なオーバーヘッドになります。

site-architecture スキルを改善する方法

重要な制約を具体的に伝える

最良の出力は、プラットフォーム、ホスティング形態、インデックス目標を明示した入力から生まれます。静的ホスティング、SSR、CMS ベースの配信、ハイブリッド構成のどれか、そしてどのセクションをクローラーから遮断する必要があるかを伝えてください。そうすると推測が減り、実装可能な提案になりやすくなります。

ホームページだけでなくページ種別を共有する

site-architecture の結果を良くするには、主要な URL クラスを列挙してください。たとえば、商品ページ、ブログ記事、カテゴリページ、ドキュメント、ログインページ、管理画面、絞り込み検索ページです。そうすれば、インデックス対象のテンプレートと除外すべき URL を切り分けられます。これが、きれいなアーキテクチャと無駄なクロール消費を分けることが多いです。

よくある失敗パターンに注意する

よくある見落としは、robots.txt で有用なページをブロックしてしまうこと、重複 URL や価値の低い URL を公開してしまうこと、テンプレート間でメタデータの付け方が不一致になることです。最初の出力が一般的すぎるなら、たいていは入力が弱いのが原因です。URL の具体例がない、コンテンツの優先順位が曖昧、技術スタックの制約に触れていない、といったケースが考えられます。

根拠をもとに反復する

最初の提案のあとで、実ファイルとログに照らして確認してください。サイトマップの網羅性をチェックし、robots.txt を見直し、代表的な数ページでレンダリング後のメタデータを確認します。そのうえで、「faceted URL 向けに調整してほしい」「staging と production の bot アクセスをより厳密に分けたい」のように、壊れている部分だけを絞って再依頼してください。そうすると site-architecture スキルの焦点がぶれず、2回目の提案でより良い技術判断が得られます。