サイトのパーソナライズ
目標
生成済みの静的サイトを、テンプレート、デモ、またはコピーした参考サイトではなく、ユーザー自身のサイトのように感じられるようパーソナライズします。
このスキルはコンテンツとメタデータを編集します。テーマの選択、レイアウトの再設計、参考サイトの再作成、大規模な記事アーカイブの移行、サイトの公開、またはプロジェクトの別のフレームワークへの変換は行いません。
契約
入力:
- 既存の生成済み静的サイトフォルダ、
EDITING.md、ページマップ、またはハンドオフノート。 - ユーザーが提供するアイデンティティ/コンテンツ: 経歴、履歴書、GitHub README、古いホームページ、ソーシャルリンク、プロジェクト、アバター/ロゴ、連絡先詳細、または特定の置換指示。
- 置き換える既存のデータファイル、JavaScriptデータブロック、メタデータ、プレースホルダー/ソースサイトのコンテンツ。
出力:
- パーソナライズされた表示コンテンツ、メタデータ、リンク、画像、ソースレベルのアイデンティティフィールド。
- テンプレート/デモ/ソースサイトの残骸の削除または置換。
- 入力済みフィールド、残りのプレースホルダー、コンテンツの場所を説明する更新済みの
EDITING.md。
境界:
- 新しいテーマの選択、レイアウトの再設計、新しい参考サイトの再作成、大規模な書き物アーカイブのインポート、公開、またはフレームワークの変換は行わないこと。
- 特定の個人の事実、雇用主、学校、賞、日付、場所、または指標をでっち上げないこと。
- 最終レポートにユーザーの個人データを不必要に貼り付けないこと。
成功条件:
- ユーザーが提供したアイデンティティ/コンテンツが、ブラウザで表示される正しい場所に表示される。
- 重要なプレースホルダーとソースサイトのアイデンティティが削除されているか、意図的に文書化されている。
- 変更された内部リンク/アセットがページ相対のままで有効である。
review-static-siteが合格するか、許容可能な制限のみを報告する。
条件が満たされない場合:
- HTML、メタデータ、データファイル、JavaScriptでレンダリングされたコンテンツを再インベントリする。
- 見逃したプレースホルダー/ソース文字列を置き換える。
- 新しいコンテンツが原因で発生した小さなレイアウトの問題には
edit-site-partを使用する。 - 修正後、再度
review-static-siteを使用する。
1. 入力
入手可能な資料を使用する:
- 静的サイトフォルダ。通常は
site/、dist/、out/、またはpublic/。 - 別のスキルからの
EDITING.md、ページマップ、またはハンドオフノート。 - ユーザーが提供する経歴、履歴書、CV、GitHub README、古いホームページ、ソーシャルリンク、プロジェクトリスト、アバター、ロゴ、または連絡先詳細。
profile.json、posts.json、projects.jsonなどの既存のデータファイル、またはassets/script.js内のデータブロック。- ユーザーからの具体的な置換指示。
重要な情報が不足している場合は、個人的な事実をでっち上げるのではなく、明確なプレースホルダーを使用する。
2. コンテンツインベントリ
編集前に、パーソナルコンテンツやプレースホルダーコンテンツがどこにあるかを特定する。
確認する項目:
- HTMLファイルとサブページ。
<title>、メタディスクリプション、Open Graph/Twitterメタデータ、ファビコン/ロゴ参照、表示見出し。- ヘッダー、ナビゲーション、ヒーロー、プロフィール/概要セクション、連絡先ブロック、フッター、サイドバー、カード、オーバーレイ。
- JSONファイル、JavaScriptデータブロック、または繰り返されるHTMLリスト内の繰り返しコンテンツ。
- 記事/詳細デモページ、プロジェクトページ、ノートページ、リンクページ、特別なページ。
EDITING.mdの指示と文書化されたコンテンツの場所。
your name、[email protected]、example.com、lorem ipsum、sample post、sample project、TODO、replace meなどの一般的なプレースホルダーやデモテキストを探す。
3. 個人アイデンティティの置換
表示およびソースレベルのアイデンティティフィールドを一貫して置き換える。
一般的なフィールド:
- サイトタイトル、著者名、表示名、役割、タグライン、短い経歴、所在地、可用性/ステータス、関心事。
- メール、ソーシャルリンク、GitHub、X/Twitter、LinkedIn、Bluesky、RSS、ニュースレター、履歴書/CV、その他ユーザーが提供したリンク。
- アバター、ロゴ、ファビコン、altテキスト、画像キャプション、プロフィールラベル。
- ホームページのヒーローコピー、アバウトページのコピー、コンタクトページのコピー、フッターテキスト、メタデータの説明。
特定の雇用主、学校、賞、出版物、指標、所在地、年をでっち上げないこと。ユーザーが何も提供していない場合は、ニュートラルで置き換えやすい状態を保つ。
リンクやアセットを置き換える際は、静的パスの互換性を維持する:
- サイトローカルのリンクとアセットはページ相対パスに保ち、ルート絶対パスにしない。
- ルートページからは、
assets/avatar.png、about.html、posts/example.htmlのようなパスを使用する。 - ネストされたページからは、
../assets/avatar.pngや../index.htmlのように正しい深さを使用する。 - 内部リンクに
/assets/...、/posts/...、/images/...、/data/...、または/を導入しない。ただし、サイトが意図的にサーバールートのみであり、ユーザーが直接ファイルを開くと壊れることを承知している場合は除く。 - GitHub、LinkedIn、メール、個人ドメインなどの外部リンクは絶対URLのままでよい。
4. ソースサイトとテンプレートのクリーンアップ
スタイル再現サイトをパーソナライズする場合、デフォルトで元のサイトのアイデンティティとソース固有のコンテンツを削除する。
置き換えるか削除するもの:
- 元の著者名、ハンドル、ドメイン、メール、ソーシャルリンク、アナリティクスID、友人リンク、プライベートURL、ライセンステキスト、サイト統計、コミュニティリンク。
- 元の記事カタログ、記事本文テキスト、プロジェクト名、個人の推薦文、個人の主張。
- ダウンロードしたアバター、カバー画像、スクリーンショット、ロゴ、または元のサイトからのその他のアセット。ただし、ユーザーが所有しているか許可を得ている場合は除く。
視覚的な構造とインタラクションパターンは維持するが、コンテンツは明確にユーザーのものにするか、ニュートラルなプレースホルダーコンテンツのままにする。
5. コンテンツの適応
ユーザーの素材を、サイトの既存のスタイルとレイアウトに適応させる。生の長いテキストをそのまま貼り付けない。
サイトのコンセプトを使用してコピーを形成する:
- ミニマルサイト: 簡潔、落ち着いた、直接的。
- ターミナル/アーカイブスタイル: プロフィール、ログ、ステータス、ディレクトリ、または設定のような表現。
- ベントースタイル: 短いモジュール形式のスニペット。
- 研究ホームページ: フォーマル、正確、プロジェクト/出版指向。
- ブログまたはデジタルガーデン: 執筆トピック、最近のノート、タグ、読書パス。
- ポートフォリオ: 厳選した作品、役割、成果、使用技術スタック、リンク。
テキストの長さは既存のコンテナに適したものにする。ユーザーが提供した段落がカードには長すぎる場合は、要約し、完全版はアバウトページに配置する。
既存の集中データソースを編集することを優先する。コンテンツがファイル間で繰り返されている場合は、すべての表示およびメタデータのコピーを一貫して更新する。
6. 検証
実際に利用可能なインタラクティブブラウザツールを最初の選択肢として使用し、ローカルプレビューを検査してパーソナライズされたコンテンツが適切な場所に実際に表示されていることを確認する。「利用可能」とは、現在のターンの呼び出し可能なツールリストに公開されていることを意味する。Codexでは、これはターンにルーティングされた場合のブラウザ/アプリ内ブラウザプラグインである可能性がある。他のエージェントでは、同等の表示可能なブラウザ、ブラウザ使用ツール、またはdevtoolsベースのブラウザである可能性がある。
インタラクティブブラウザツールが呼び出し可能でない場合、ブラウザ配置チェックが行われたふりをしてはならない。視覚的な配置が重要な場合は、ユーザーにブラウザツールを有効にするか呼び出すよう依頼する。Codexの場合、明示的に@browserに言及したリクエストを送信することを意味する場合がある。ユーザーがルーティングを変更しない場合、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、静的監査、またはソースチェックにフォールバックし、その制限を伝える。
インタラクティブブラウザツールが実際に呼び出し可能である場合、Playwrightまたはスクリーンショットのみの検証をデフォルトにしないでください。Playwrightは、インタラクティブブラウザツールが呼び出し可能でない場合、ユーザーが明示的に要求した場合、または繰り返し可能なスクリプト化された回帰テストが特に必要な場合にのみフォールバックとして使用する。
ユーザーの情報が表示されるべきページ(ホーム、アバウト/プロフィール、コンタクト、プロジェクト、リンク、代表的な記事/詳細ページなど)を確認する。ユーザーが提供した名前、タグライン、経歴、アバター/ロゴ、連絡先詳細、ソーシャルリンク、プロジェクト名、おすすめアイテムが期待される場所に表示されていることを確認する。
また、重要なプレースホルダーコンテンツやソースサイトのアイデンティティがブラウザにまだ表示されていないことも確認する。これはコンテンツ配置チェックであり、完全なビジュアルリデザインパスではない。
パーソナライゼーションによってアバター、ファビコン、ソーシャルアイコン、プロジェクトリンク、投稿リンク、またはデータ駆動型カードが変更された場合は、変更されたパスが影響を受けるページの深さから機能し、不用意なルート絶対サイトローカルパスが導入されていないことを確認する。
最後にreview-static-siteを呼び出すか、提案する。
編集ガイド
EDITING.mdが存在する場合は更新し、サイトが再利用可能であることを意図している場合は作成する。
記録する内容:
- どの個人フィールドが入力されたか。
- どのコンテンツがプレースホルダーのままか。
- プロフィール、リンク、プロジェクト、おすすめアイテム、投稿、画像、テーマテキストが現在どこにあるか。
- サイトにコピーされたユーザー提供のアセットと、それらがどこで参照されているか。
- 意図的に削除または置換されたソースサイトのコンテンツ。
このガイドは将来のエージェントやユーザーのために残し、ウェブサイト内のマーケティングコピーとしてではなく、内部的な参考資料として保管する。
出力
完了したら、簡潔に報告する:
- どの個人情報とページが更新されたか。
- どのファイルが変更されたか。
- どのプレースホルダーまたはソース固有の残骸が残っている場合、その詳細。
review-static-siteが実行されたか、次に実行すべきか。
ユーザーの個人データを不必要に貼り付けないこと。