スタイルリファレンスを探す
目標
選んだ、または大まかに決めた個人サイトのスタイルを、実装に入る前に具体的で検証済みのデザインリファレンスに変換します。
このスキルはリサーチおよびデザインブリーフ作成のスキルです。サイトを構築したり、単一のターゲットWebサイトを複製したりはしません。複数の実際のリファレンスを見つけ、調査し、再利用可能なデザインパターンを抽出し、make-personal-siteで構築可能なブリーフを生成します。
契約
入力:
- ユーザーのスタイル方向性、テーマワード、サイトタイプ、オーディエンス、コンテンツ範囲、リファレンス、または制約。
- 含める/避けるべきオプションの例、優先するプラットフォーム/テンプレートソース、ターゲットサイト構造。
出力:
- 利用可能な場合、4~8個の関連リファレンス候補(ソースURLと簡単な選定理由付き)。
- ツールが利用可能な場合、選定されたリファレンスに対するブラウザまたはスクリーンショットの観察結果。
- レイアウト、ナビゲーション、ファーストビュー、記事一覧、記事詳細、プロジェクト/アバウト領域、カラー、タイポグラフィ、画像、モーション、インタラクション、レスポンシブ動作をカバーする実用的なリファレンスブリーフ。
- 「採用」と「避ける」に関する明確な注記。
make-personal-siteへの最終的な構築ハンドオフ。
境界:
- Webサイトを実装しない。
- 保護されたソースコード、画像、個人情報、アナリティクスID、ブランドアセットをコピーしない。
- 1つのリファレンスを複製ターゲットとして扱わない。ユーザーが特定のサイトのコピーを希望する場合は、
copy-website-styleにルーティングする。 - フレームワークのインストールや構築の実現可能性に時間を費やさない。このスキルはデザインリファレンスの調査のみを行う。
成功ゲート:
- 方向性が具体的なリファレンスに基づいており、
make-personal-siteがオリジナルの静的サイトを構築するのに十分具体的である。 - リファレンス調査に複数の検索角度を使用しており、単一のキーワードではない。
- ユーザーが明示的に迅速なドラフトを要求した場合を除き、可能な限り少なくとも3つの強力なリファレンスが調査された。
- 最終ブリーフが、コピーすべきでないコンテンツ/アイデンティティから、再利用可能なデザイン言語を分離している。
ゲート失敗時:
- より広い、または代替のキーワードで検索する。
- より少ない、より強力なリファレンスのセットを調査する。
- 方向性自体がまだ不明確な場合は、
search-blog-themeに戻る。 - 複数のリファレンスファミリーが大きく異なるサイトにつながる場合にのみ、簡潔な好みの質問を1つ行う。
使用すべき時
このスキルは以下の場合に使用します:
- ユーザーがすでに「自然なテクニカルブログ」「静かな研究ホームページ」「レトロターミナルアーカイブ」「居心地の良いメモサイト」「ブルータリストポートフォリオ」などの大まかな方向性を示している。
search-blog-themeが方向性を推奨したが、構築前に実際の例が必要である。from-idea-to-personal-siteが具体的なリファレンスURLではなく、テイストワードからオリジナルサイトを構築しようとしている。make-personal-siteの前にエージェントがより多くのビジュアル的根拠を必要としている。
このスキルは以下の場合には使用しません:
- ユーザーがまだ方向性を選択していない。
search-blog-themeを使用します。 - ユーザーが1つのターゲットURLを提供し、それを忠実に再現したい。
copy-website-styleを使用します。 - サイトがすでに存在し、小さな変更のみが必要である。
edit-site-partを使用します。
ワークフロー
-
スタイルの方向性を内部で検索可能なキーワードに言い換える。 入力: ユーザーのテイストとサイトの目的。 出力: 複数の角度からの5~10の検索フレーズ。 ゲート: 検索フレーズが、ムード、サイトタイプ、ビジュアルシステム、構造、そして少なくとも1つの代替表現をカバーしている。
-
実際のリファレンスを検索する。 入力: 検索フレーズ。 出力: 候補となるWebサイト、テンプレート、ポートフォリオ、ブログ、デザインページ、またはGitHubデモ。 ゲート: ユーザーが明示的に迅速なドラフトを要求した場合を除き、リファレンスを確定する前に少なくとも3つの異なる検索角度を使用する。
-
選択したリファレンスを調査する。 入力: 最有力候補。 出力: ブラウザ/スクリーンショットの観察結果。 ゲート: 可能な限り少なくとも3つの強力なリファレンスが調査される。方向性が広い場合は4~6を使用する。
-
デザインパターンを抽出する。 入力: 調査済みリファレンス。 出力: 再利用可能なパターンとアンチパターン。 ゲート: 注記が、単なる雰囲気ではなく、レイアウト、階層、インタラクション、タイポグラフィ、カラー、コンテンツ密度、レスポンシブ動作に関するものである。
-
1つの構築ブリーフを合成する。 入力: リファレンスパターンとユーザーの制約。 出力:
make-personal-siteのための簡潔なデザインブリーフ。 ゲート: ブリーフが、追加の調査パスなしで実装できるほど具体的である。
検索ガイダンス
以下の組み合わせから検索を構築します:
- サイトタイプ: 個人Webサイト、個人ブログ、ポートフォリオ、研究ホームページ、デジタルガーデン、メモサイト、開発者ブログ。
- ムード: 自然、落ち着いた、エディトリアル、居心地が良い、生々しい、ブルータリスト、ターミナル、アーカイブ、ノートブック、ガーデン、ミニマル、遊び心がある、科学的。
- 構造: ブログホームページ、記事インデックス、プロジェクトグリッド、サイドナビゲーション、bento、タイムライン、メモアーカイブ、nowページ。
- ソース: v0テンプレート、Figmaコミュニティ、GitHubテーマ、個人Webサイト、Astro/Hugo/Jekyll/Quartzの例、デザインインスピレーションサイト。
漠然としたフレーズよりも具体的なフレーズを優先します。例:
- natural developer personal website
- calm technical blog personal site
- digital garden nature inspired design
- research homepage personal website minimal
- personal blog template notes projects
1つの検索フレーズや最初の魅力的な結果で止まらないでください。サイバーパンクなテクニカルホームページのような方向性の場合、複数の角度から検索してください。例:
- cyberpunk developer personal website
- futuristic technical blog personal site
- terminal cyberpunk portfolio website
- neon brutalist personal website
- sci fi interface personal homepage
テンプレート、ポートフォリオ、デザイン例は時間とともに変化するため、現在のWeb検索を使用してリファレンスを検索します。
ブラウザ調査
強力なリファレンスごとに、実際に利用可能なインタラクティブブラウザツールを使用してライブページを調査します。「利用可能」とは、現在のターンで呼び出し可能なツールリストに公開されていることを意味します。Codexでは、ターンにルーティングされた場合、これはBrowser/アプリ内ブラウザプラグインである可能性があります。他のエージェントでは、同等の可視ブラウザ、browser-useツール、またはdevtools対応ブラウザである可能性があります。
インタラクティブブラウザツールが呼び出し可能でない場合、リファレンスがブラウザで視覚的に調査されたふりをしないでください。視覚的なリファレンスの忠実度が重要な場合は、ユーザーにブラウザツールを有効化または呼び出すよう依頼してください。Codexの場合、それは明示的に@browserに言及するリクエストを送信することを意味する可能性があります。ユーザーが再ルーティングしない、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、検索結果スニペット、ソースページ、または記述にフォールバックし、その制限を明記します。
インタラクティブブラウザツールが実際に呼び出し可能な場合、デフォルトでPlaywright、スクリーンショットのみのレビュー、または検索結果スニペットに頼らないでください。スクリーンショットはインタラクティブブラウザパスの後に証拠としてキャプチャできますが、インタラクティブ調査の代わりにはなりません。Playwrightは、インタラクティブブラウザツールが呼び出し可能でない場合、ユーザーが明示的に要求した場合、または繰り返し可能なスクリプト化された比較が特に必要な場合にのみ、フォールバックとして使用します。
チェック項目:
- ファーストビューポート: すぐに何が役立つか?
- ナビゲーション: トップナビ、サイドナビ、コマンド/メニュー、タグ、検索、アーカイブリンク。
- コンテンツモデル: 投稿、メモ、プロジェクト、アバウト、リンク、レコード、now、ガーデン、履歴書。
- 読みやすさ: 記事幅、タイポグラフィ、コードブロック、数式、画像、脚注、目次。
- ビジュアルシステム: パレット、スペーシング、ボーダー半径、密度、カード、区切り線、テクスチャ、画像。
- モーションとインタラクション: ホバー状態、テーマ切り替え、フィルター、検索、スクロール効果、ページトランジション。
- レスポンシブ動作: モバイルではどうなるべきか?
- リスク: 何が読みにくくなりすぎるか、一般的すぎるか、重くなりすぎるか、ソースに近くなりすぎるか?
ブラウザツールが利用できない場合は、ソースページ、検索結果スニペット、スクリーンショット、記述メモを使用し、視覚的調査が制限されたことを明記します。
出力形式
応答は自然で有用に保ちます。長い非表示のプロセスログを公開しないでください。
以下を含めます:
- 簡単な推奨: 構築すべき最も強力な方向性。
- リファレンス: 4~8項目(URL/ソースと、それぞれが重要である理由)。
- 採用: 適応すべき具体的なパターン。
- 避ける: コピーすべきでないもの、またはユーザーのサイトに悪影響を与えるもの。
- 構築ブリーフ:
make-personal-siteのための正確な方向性。 - ハンドオフ: 推奨される次のスキルと、あればソース制約。
ユーザーが簡単な回答を求めた場合は、最良の3~5のリファレンスと1つのブリーフに出力を圧縮します。
構築ブリーフ要件
最終ブリーフは以下を指定する必要があります:
- サイトアイデンティティ: サイトが一言でどのように感じられるべきか。
- ページ範囲: ホーム、ブログインデックス、投稿詳細、プロジェクト、アバウト、メモ/レコード、リンク、またはその他のページ。
- ファーストビュー: どのような有用なコンテンツがすぐに表示されるか。
- レイアウト: ナビゲーション、コンテンツカラム、サイドバー、カード/リスト、アーカイブ構造。
- ビジュアルシステム: カラーパレット、タイプスタイル、スペーシング、ボーダー、画像、アイコンスタイル。
- インタラクション: テーマ切り替え、フィルター/検索、コピーボタン、ホバー状態、オプションのモーション。
- レスポンシブ動作: モバイルナビゲーションとコンテンツの優先順位。
- コピーしないもの: オリジナルの個人情報、記事、アセット、ロゴ、プロプライエタリコード、アナリティクス、または正確なブランド処理。
ハンドオフ
ブリーフの準備ができたら:
- オリジナルサイトの構築は
make-personal-siteにルーティングします。 - 単一サイトのクローン再現は
copy-website-styleにルーティングします。 - 未解決の方向性の選択は
search-blog-themeに戻します。