個人サイトを作成する
目標
個人ウェブサイトをプレーンな静的ファイル(HTML、CSS、必要に応じてバニラJavaScript)として作成またはリデザインします。
このスキルは、視覚的な方向性が決まった後の実装ステップです。テーマの推奨、ユーザープロフィール、メモ、サンプル記事、プロジェクトの説明、または既存の静的サイトフォルダを、実際に動作する個人サイトに変換します。
核となる約束:
- フレームワーク不要。
- ビルドステップ不要。
- パッケージインストール不要。
- ランタイム依存関係なし。
index.htmlを直接開いて手動プレビュー可能。- ページ相対リンクとアセットを使用し、直接ファイルを開く、ローカルHTTP、静的ホスティングのすべてで動作。
- フォルダを静的ホスティングにデプロイ可能。
自動ブラウザQAの場合は、file:// URLではなく、静的フォルダをローカルHTTPで提供します。
契約
入力:
- テーマの方向性、ユーザープロフィール素材、必要なページ、サンプルコンテンツ、または既存の静的フォルダ。
- 高忠実度の再現を要求せずにスタイルのガイドとなるオプションの参考資料。
- 希望する出力フォルダと静的ファイルの制約。
出力:
- HTML、CSS、オプションのバニラJavaScript、ローカルアセット、代表的なページタイプを含むプレーンな静的サイトフォルダ。
- 新しいサイトまたは大幅なリデザインを作成した場合の将来の編集のための
EDITING.md。 - ローカルプレビュー手順と検証サマリー。
境界:
- 特定のターゲットウェブサイトを厳密に再作成しないでください。
copy-website-styleを使用してください。 - 大規模な文章アーカイブをインポートしないでください。
add-blog-postsを使用してください。 - 公開やホスティング設定を行わないでください。
publish-static-siteを使用してください。 - ユーザーが明示的に要求しない限り、フレームワーク、パッケージインストール、バックエンド、CMS、認証、データベースを導入しないでください。
成功ゲート:
- 必須のページタイプが存在し、ナビゲーションが実際の相対パスを指していること。
- サイトがビルドステップなしでプレーンな静的ファイルとして動作すること。
- ソースがUTF-8で読み取り可能であり、プレースホルダーが明確であり、
review-static-siteが合格するか、承認された制限のみを報告すること。
ゲートに失敗した場合:
- 不足しているページタイプ、パス、アセット、エンコーディング、プレースホルダー、またはブラウザの問題をこのスキル内で修正します。
- 失敗がユーザーのアイデンティティ/コンテンツの欠落である場合は、
personalize-siteを使用します。 - 修正後、再度
review-static-siteを使用します。
簡易パイプライン
個人サイトの新規作成作業には、以下のパイプラインに従ってください:
- サイトの目的、テーマの方向性、利用可能なコンテンツ、ページ範囲を明確にします。
- コーディング前に、静的ページマップとプレースホルダー戦略を決定します。
- 最初に共有シェル(ヘッダー、ナビゲーション、メインレイアウト、フッター、グローバルCSS変数、共有インタラクション)を構築します。
- ホームページと、要求されたまたは暗示されるすべてのページタイプを実装します。
- ユーザーのコンテンツまたは明確に置き換え可能なプレースホルダーを使用します。詳細な個人情報を捏造しないでください。
- 将来のモデル/ユーザーによる編集のための編集ガイドを追加します。
- 相対リンクとアセットを使用した直接開封パスの互換性を確認します。
- 実際のブラウザでHTTP経由でローカル検証します。
- 最終納品前に、リンク、アセット、ページタイプ、UTF-8ソースの読みやすさを確認します。
使用する場合
以下の場合にこのスキルを使用します:
- ユーザーがプレーンなHTML/CSS/JSの個人サイト、ブログ、ホームページ、ポートフォリオ、研究ホームページ、または静的ウェブサイトを希望する場合。
search-blog-themeで生成されたテーマの方向性を実装するように依頼された場合。- 検査、編集、デプロイが簡単なシンプルなノーフレームワークサイトを希望する場合。
- 依存関係のない状態を保ちながら、既存の静的サイトをリデザインしたい場合。
- 大まかな視覚的参考資料を提供するが、高忠実度の再現を必要としない場合。
使用しない場合
以下の場合にはこのスキルを使用しないでください:
- ユーザーがテーマを検索したり、視覚的な参考資料を比較したいだけの場合。
search-blog-themeを使用してください。 - 特定のウェブサイトの見た目、レイアウト、動き、または操作感を厳密に再現したい場合。
copy-website-styleを使用してください。 - 多数の記事を移行したり、Obsidianノートを変換したり、フロントマターを修復したり、大規模なコンテンツアーカイブを移動したい場合。
add-blog-postsを使用してください。 - デプロイ、DNS、GitHub Pages、Cloudflare Pages、Cloudflare Pages Direct Upload、Netlify、Vercelのヘルプのみを希望する場合。
publish-static-siteを使用してください。 - ユーザーがNext.js、Astro、Hugo、Jekyll、Quartz、Reactなどのフレームワークプロジェクトを明示的に要求した場合。
- ユーザーがバックエンド、データベース、認証、CMS、コメントシステム、または動的サーバー動作を要求した場合。
入力
ユーザーが提供するものを使用します。詳細が不足していてもブロックしないでください。
有用な入力例:
- テーマの方向性: プライベートコードアーカイブ、研究ログダッシュボード、デジタルガーデン、ベントーポートフォリオ、フィールドノートブック、パーソナルオペレーティングシステムなど。
- ユーザープロフィール: 名前、短い経歴、役割、場所、ソーシャルリンク、アバター、履歴書、出版物、プロジェクト。
- 必要なページ: ホーム、アバウト、ブログ、プロジェクト、ノート、出版物、お問い合わせ。
- サンプルコンテンツ: 1~3件の記事、プロジェクトの説明、Markdownスニペット、古いHTMLページ。
- 既存のサイトフォルダ: 維持またはリファクタリングする現在のHTML/CSS/JSファイル。
- 大まかな参考資料: v0、Figma、GitHubテーマ、フレームワークテンプレート、スクリーンショット、ムード参考資料。
参考資料ルール
参考資料はどのスタックからでも提供される可能性があります。これらを実装の選択ではなく、視覚的および構造的な参考資料として扱います。ユーザーがそのフレームワークの使用を明示的に要求した場合を除きます。
プレーンな静的サイトの場合、参考資料を次のように変換します:
- React、Next、Astroコンポーネント -> 再利用可能なCSSクラスを持つ繰り返しHTMLセクション。
- Tailwindユーティリティクラス ->
assets/style.css内の通常のCSSルール。 - フレームワークルート -> リンクされた
.htmlファイル。 - コンテンツコレクションまたはCMSデータ -> 静的HTMLリストまたは小さなJSONファイル。
- テーマ設定 -> CSSカスタムプロパティ。
- シンプルなインタラクション -> 有用な場合にのみバニラJavaScript。
ユーザーが特定のウェブサイトを厳密に一致させたい場合は、大まかな参考資料として扱う代わりに、copy-website-styleに引き継ぎます。
デフォルトのサイト構造
新しいサイトの場合、ユーザーが別の指定をしない限り、以下の構造を推奨します:
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
既存のサイトの場合は、実用的な範囲でユーザーの現在の構造を維持します。要求された作業を明確に改善する場合を除き、サイトの大部分をリネームしたり再編成したりしないでください。
ページの期待
ユーザーの要求に必要なページのみを作成します。完全な個人サイトスターターの場合、以下を含めます:
- ホーム: アイデンティティ、短い紹介、テーマ固有のヒーローエリア、最近の投稿、厳選プロジェクト。
- アバウト: 経歴、関心、スキル、お問い合わせ、ソーシャルリンク、オプションの履歴書/出版物。
- ブログインデックス: タイトル、日付、タグ、サマリー付きの記事リスト。
- 記事ページ: タイトル、日付、タグ、コンテンツ、ブログインデックスへのナビゲーションを備えた読みやすい記事レイアウト。
- プロジェクト: 説明、スタック、リンク、成果を備えたプロジェクトカードまたは行。
最初の画面を有用に保ちます。ユーザーが個人サイトやブログを要求したのに、マーケティング用ランディングページを作成しないでください。
完全な個人サイトまたはブログスターターの場合、単一のホームページで停止しないでください。コンテンツがプレースホルダーのみの場合でも、動作する代表的なページタイプを作成します:
- ブログの場合は少なくとも1つの記事/詳細ページ。
- サイトの一部に記事、ノート、プロジェクト、出版物が含まれる場合は、リストまたはアーカイブページ。
- ホームページがアイデンティティや背景詳細にリンクしている場合は、プロフィール/アバウトページ。
- 選択されたコンセプトによって暗示される特別なページ(ノート、リンク、ガーデン、Now、Uses、出版物、実験など)。
大規模な将来のコンテンツコレクションの場合は、完全なアーカイブを捏造するのではなく、構造と少数の代表的なプレースホルダーエントリを作成します。
パス互換性ルール
生成されたプレーンな静的サイトは、ユーザーがindex.htmlを直接開いた場合、ローカルHTTPで提供された場合、一般的な静的ホストにデプロイされた場合に動作する必要があります。
デフォルトルール:
- すべてのサイトローカルリンクとアセットにページ相対パスを使用します。
- ルートページからは、CSS/JS/画像を
assets/style.css、assets/script.js、assets/images/avatar.pngとしてリンクし、ページをabout.htmlまたはposts/example.htmlとしてリンクします。 posts/example.htmlなどのネストされたページからは、共有アセットを../assets/style.cssとして、ルートページを../blog.htmlまたは../index.htmlとしてリンクします。- ユーザーがサーバールートのみの動作を明示的に受け入れない限り、
/assets/style.css、/assets/script.js、/posts/example.html、/data/posts.json、/images/foo.png、/などのルート絶対パスを使用しないでください。 - CSS
url(...)、ファビコン、Open Graph画像、カバー画像、フォント、KaTeX/数式ベンダーアセット、RSS/サイトマップリンク、JavaScript生成URLにも同じルールを適用します。 - ページを移動または追加する場合、ルートページからリンクをコピーするのではなく、そのページのフォルダの深さに基づいてパスを再計算します。
サーバーのみの前提を避ける:
- 直接開封プレビューが約束の一部である場合、コアナビゲーション、記事リスト、ホームページコンテンツに
fetch("data/posts.json")などのローカルファイルフェッチに依存しないでください。 - 繰り返しデータが有用な場合は、コンテンツを直接HTMLにレンダリングするか、相対
<script src="assets/script.js">で読み込まれるローカルJavaScriptオブジェクトにデータを保存します。 - オプションの拡張機能は、そのフェッチがなくてもページが正しく読み取りおよびナビゲートできる場合にのみ、データファイルを使用しても構いません。
スタイルルール
選択したテーマに視覚言語を導かせますが、サイトを読みやすく、保守しやすい状態に保ちます。
- サイト全体のスタイルを
assets/style.cssに配置します。 - 色、スペーシング、境界線、タイポグラフィの選択にCSSカスタムプロパティを使用します。
- 可能な限りセマンティックHTMLを使用します:
header、nav、main、article、section、footer。 - レスポンシブレイアウトルールを使用して、ページがモバイルとデスクトップで動作するようにします。
- テーマが視覚的に強い場合は、記事ページをホームページよりも落ち着いたものにします。
- ユーザーが特定のフォントを要求した場合、またはテーマが強く必要とする場合を除き、システムフォントを優先します。
- ユーザーが提供するか、明確に許容できる場合を除き、リモートアセットに依存しないでください。
- 装飾効果が読書、ナビゲーション、アクセシビリティを妨げないようにします。
インタラクションルール
明確な価値を追加する場合にのみ、バニラJavaScriptを使用します。
良い使用例:
- モバイルナビゲーションの切り替え。
- テーマの切り替え。
- 軽量なタグまたは記事のフィルタリング。
- コアな読書に影響を与えない小さなプログレッシブエフェクト。
避けるべきこと:
- 重いアニメーションフレームワーク。
- ユーザーが明示的に要求しない限り、キャンバスを多用した装飾。
- 開発サーバーやパッケージインストールを必要とするエフェクト。
- 読書を妨げる継続的なちらつき、攻撃的なグリッチ、またはスクロールエフェクト。
アニメーションテーマの場合は、prefers-reduced-motionを尊重します。
静的簡略化ルール
大まかな参考資料に複雑なまたはフレームワーク依存の機能がある場合、それらをより単純な静的同等物に変換します:
- 3D地球儀 -> トピックマップ、ステータスパネル、プロジェクトコンステレーション、または静的な視覚ブロック。
- アニメーションベントグリッド -> 微妙なホバー状態を持つレスポンシブCSSグリッド。
- ターミナルシミュレーター -> テーマに沿ったナビゲーションとログ形式のコンテンツ。有用でない限り、偽のコマンドラインは使用しません。
- ナレッジグラフ -> タグ、関連記事、トピックインデックス、または手動でキュレーションされたリンク。
- 動的検索 -> シンプルなフィルター入力、静的タグページ、または最初のバージョンでは検索なし。
- CMS駆動の記事 ->
posts/*.htmlとdata/posts.json。
過剰に構築された参考資料のコピーよりも、ユーザーの望む感覚を捉えたクリーンな静的バージョンを優先します。
既存サイトルール
既存のサイトを変更する場合:
- 編集前に現在のファイル構造を確認します。
- ユーザーのコンテンツと無関係なファイルを保持します。
- 変更を要求されたページとアセットに限定します。
- 既存の視覚的慣例がすでに機能している場合は、それを再利用します。
- ユーザーが完全なリデザインを要求しない限り、サイト全体を置き換えないでください。
- サイトにすでに
style.cssまたはscript.jsがある場合は、競合する重複を作成する代わりに、それらを注意深く拡張します。
コンテンツルール
少量的なコンテンツの場合は、静的HTMLを直接記述します。
記事やプロジェクトなどの繰り返しコンテンツには、以下のいずれかを使用します:
- リストが短い場合は、静的に繰り返しHTML。
- 保守性が向上する場合は、ローカルJavaScriptデータオブジェクトとバニラJavaScriptレンダリング。
- その機能にローカルHTTP/静的ホスティングが必要であることが許容され、コアページがそれなしでも動作する場合にのみ、小さなJSONファイル。
詳細な個人情報を捏造しないでください。ユーザーデータがない場合は、プレースホルダーを明確に使用します。
プレースホルダーを簡単に見つけて置き換えられるようにします。繰り返しコンテンツは、data/*.json、assets/script.js内の文書化されたデータブロック、または安定したクラス名を持つ繰り返しHTMLセクションなど、明確に名前が付けられた場所に保存することを優先します。
プレースホルダーのみのテキスト、デモ記事、サンプルプロジェクト、モックリンクを、ユーザーまたは将来のモデルが公開前に置き換えられるように、ファイルまたはEDITING.mdに明確にマークします。
編集ガイドルール
新しいサイトを作成するか、既存のサイトを大幅にリデザインする場合は、出力フォルダにEDITING.mdを含めます。
EDITING.mdは、主に後で生成されたサイトを変更する将来のモデルまたはエージェント向けです。簡潔でありながら具体的に保ちます。以下を説明します:
- フォルダ階層と各ファイル/フォルダの目的。
- サイトで使用されるファイル形式: HTML、CSS、JS、JSON/データブロック、画像。
- ページマップ: どの生成ファイルがホーム、アバウト/プロフィール、ブログ/リスト、記事/詳細、プロジェクト、ノート、リンク、またはその他のページタイプであるか。
- 共有レイアウト領域: ヘッダー、ナビゲーション、モバイルナビゲーション、メインコンテンツ、フッター、サイドバー、オーバーレイ、テーマコントロール。
- 各主要ホームページ領域が
index.html内のどの場所にあるか(近くのセクション/クラス名を使用)。 - 各サブページテンプレートの場所と、内部リンクがどのように接続されるか。
- 繰り返しコンテンツが保存されている場所と、期待されるオブジェクト/マークアップ形式。
- サイトタイトル、タグライン、アバター/ロゴ、ナビゲーション、注目記事、プロジェクトリスト、リンクリスト、画像、色、テーマ変数を変更する方法。
- 公開前に置き換えるべきプレースホルダーのみのコンテンツ。
エンコーディング整合性ルール
生成されたソースファイルは、ブラウザのスクリーンショットで正しく見えるだけでなく、有効なUTF-8であり、ソース形式で人間が読み取り可能である必要があります。
中国語、日本語、韓国語、アクセント付きラテン文字、またはその他の非ASCIIコンテンツを含むページや編集ガイドの場合:
- HTMLファイルに
<meta charset="utf-8">を含めます。 - ファイルをUTF-8として書き込みます。
- 最終納品前に、UTF-8対応リーダーでソースの読みやすさを確認します。