個人サイトを構築する
目標
個人サイトスキルスイートを調整し、信頼性の高いワークフローにまとめます。
これはオーケストレーションスキルであり、実装スキルではありません。適切な専門スキルへルーティングし、品質ゲートを強制し、現在のリクエストが自然な終了点に達するまでワークフローを進めます。
子スキルの詳細な実装ルールを複製してはいけません。子スキルは、そのステップに達したときにロードして従います。
ユーザーからの「アイデアから個人サイトへ」やワンクリック起動リクエストには、from-idea-to-personal-siteを優先します。次のステップや子スキルの選択が主な問題である場合、このスキルをより低レベルのルートコーディネーターとして使用します。
契約
入力:
- ユーザーリクエスト、サイトフォルダまたは出力先フォルダ、参考資料、本人確認資料、コンテンツ資料、オプションの公開ターゲット。
- ユーザーが次に何をすべきか尋ねた場合の現在のワークフロー状態。
出力:
- 選択されたワークフロールートと実行された子スキル。
- リクエストに応じて、ローカル静的サイト、検証済み既存サイト、インポートされたコンテンツ、焦点を絞った編集、または公開準備。
- サイトフォルダ、プレビュー/公開ステータス、実行された検証、残りの手動手順を含む引き継ぎサマリー。
境界:
- 専門の子スキルが適用される場合、子スキルの詳細を直接実装してはいけません。
- デフォルトですべての子スキルを実行するのではなく、リクエストを満たす最短のチェーンを選択します。
- 明示的に要求されない限り、公開、プッシュ、プロジェクト作成、ドメインのバインド、DNSの変更を行ってはいけません。
- 生成、再作成、パーソナライズ、記事インポート、または広範囲な編集の後は、
review-static-siteをスキップしてはいけません。
成功ゲート:
- 選択された子スキルチェーンがユーザーの自然な終了点(方向性選択、サイト構築、コンテンツ追加、サイト検証、編集完了、デプロイ準備/実行)に到達する。
- 必要な品質ゲートに合格するか、ユーザーが文書化された制限を明示的に受け入れる。
ゲート失敗時:
- 失敗したゲートを最小の責任子スキルにルーティングします。
- 影響を受ける検証を再実行します。
- 不足しているユーザーコンテンツ、不足している認証情報、利用不可能なアセット、外部アカウントのアクションが進行を妨げる場合のみ、ブロッカーを報告して停止します。
子スキル
これらのスキルをワークフローの構成要素として使用します:
search-blog-theme: 個人サイト/ブログのテーマ方向性を発見し比較します。find-style-references: 選択した方向性について実際のウェブサイト/テンプレート/スクリーンショットを検索・調査し、ビルド可能な参考資料概要を作成します。make-personal-site: 依存関係のないオリジナルの静的個人サイトを作成します。copy-website-style: 特定の参考ウェブサイトのスタイル、レイアウト、モーション、ページタイプを再現します。personalize-site: プレースホルダー/デモ/ソース元の本人情報をユーザー自身のコンテンツに置き換えます。add-blog-posts: Markdown、Obsidianノート、Word草稿、古いHTML記事、画像、数式、リンク、その他の文章を既存サイトにインポートします。edit-site-part: 特定のセクション、コンポーネント、コピーブロック、スタイル詳細、インタラクションに焦点を当てたローカル変更を行います。review-static-site: 静的出力のリンク、ページタイプ、ブラウザレンダリング、エンコーディング、プレースホルダーの残骸、直接開く互換性、パスの正確性を検証します。publish-static-site: GitHub Pages、Cloudflare Pages、Netlify、Vercelへのデプロイを準備または実行します。
子スキル名が変更された場合、同じ目的を持つローカルにインストールされたスキルを優先します。
子スキル契約マトリックス
このマトリックスを使用して、引き継ぎと修正ループを決定します:
| 子スキル | 必要な入力 | 期待される出力 | 成功ゲート | ゲート失敗時 |
|---|---|---|---|---|
search-blog-theme | ユーザーの好み、目的、参考資料、キーワード | 3~5つの方向性、検証済み参考URL、1つの推奨 | 方向性がビルド可能なほど具体的 | さらに参考資料を検索、比喩を明確化、または1つの好みの質問をする |
find-style-references | 選択されたスタイル方向性、サイトタイプ、ムードワード、例 | 4~8の実際の参考資料、ブラウザ観察、ビルド可能なデザイン概要 | 複数の検索角度があり、可能な場合は少なくとも3つの強い参考資料を調査済み | 検索範囲を拡大、より強い参考資料を調査、またはsearch-blog-themeに戻る |
make-personal-site | 方向性、コンテンツ/プロフィールのヒント、ページ範囲、出力フォルダ | 代表的なページ、アセット、EDITING.mdを含むプレーンな静的サイト | 必要なページタイプ、相対パス、UTF-8ソース、ローカルプレビュー | 構造/パス/アセットを修正し、その後review-static-site |
copy-website-style | ターゲットURL/スクリーンショット/テンプレートと範囲 | ページマップ、プレースホルダー/ユーザーコンテンツ、EDITING.mdを含む静的スタイル再現 | 署名のレイアウト/モーション/ページタイプが要求された忠実度に一致 | ターゲットを再調査、再現を反復、その後review-static-site |
personalize-site | 既存サイトとユーザーの本人情報/コンテンツ | 本人情報、リンク、メタデータ、アセットの置き換え、プレースホルダー/ソースのクリーンアップ | ユーザーコンテンツが表示され、残骸が除去されている | コンテンツの場所を再インベントリするか、レイアウト適合のためにedit-site-partを使用 |
add-blog-posts | 既存サイトとソース記事/アセット | 新しい記事ページ、更新されたインデックス/データ、コピーされたアセット、編集メモ | 記事がレンダリングされ、リンク/アセット/数式/リッチコンテンツが動作する | 変換/インデックス/アセットを修正するか、ローカル表示問題のためにedit-site-partを使用 |
edit-site-part | 既存サイトとターゲットページ/領域/変更 | 小さなスコープのコード/コンテンツ/スタイル/インタラクション編集 | 同じブラウザ領域に、無関係な破損なく要求された変更が表示される | ソースを再マッピングし、より小さな修正編集を行う |
review-static-site | 静的ルート、期待されるスコープ、オプションの禁止文字列/参考資料 | 結果または修正、監査/ブラウザ結果、合格/不合格状態 | ブロッカーが残っていない | ブロッカーを最小の責任子スキルにルーティング |
publish-static-site | 検証済みデプロイルートと選択されたプラットフォーム/モード | デプロイ設定/構成、オプションのライブURL、デプロイ後チェック | 正しいフォルダがデプロイされ、ライブURLが動作する | ローカルブロッカー、デプロイ設定、アカウント/DNS手順を修正 |
運用手順
- 最初にルーティングし、その後実行します。幅広い編集を行う前に正しいチェーンを決定します。
- 各ステップの出力を次のステップで利用可能に保ちます。
- ユーザーが明示的に別のスタックを要求しない限り、このバージョンではプレーンなHTML/CSS/JSと依存関係ゼロを優先します。
- 個人サイトやブログをマーケティングランディングページにしてはいけません。
- ユーザーデータがない場合、詳細な個人的事実をでっち上げてはいけません。
- スタイル再現では、デフォルトでコピーされたソースサイトの本人情報を置き換えます。
- デフォルトでページ相対リンクとアセットを使用し、
/assets/...や/posts/...のようなルート絶対サイトローカルパスは避けます。 - 生成、再作成、パーソナライズ、記事インポート、または幅広い編集の後は、
review-static-siteで検証します。 - ユーザーが明示的に公開を要求しない限り、ローカルの検証済みサイトで停止します。
- ユーザーが明示的に要求しない限り、リポジトリを作成したり、コードをプッシュしたり、デプロイしたり、ドメインをバインドしたり、DNSを変更したりしてはいけません。
情報収集
次の決定に必要な情報のみを収集します。ユーザーに過剰にインタビューしてはいけません。
有用な入力:
- 出力先フォルダまたは既存サイトフォルダ。
- ユーザーが新しいサイト、参考サイトの再現、コンテンツインポート、パーソナライズ、ローカル編集、検証、公開のいずれを希望するか。
- 参考URL、スクリーンショット、テンプレート、テーマワード。
- ユーザーの本人確認資料: 名前、経歴、リンク、履歴書、プロジェクト、アバター/ロゴ、旧ホームページ、GitHubプロフィール。
- コンテンツ資料: マークダウン、Obsidianノート、Word文書、古い記事、画像フォルダ、貼り付けられたテキスト。
- 公開ターゲット: GitHub Pages、Cloudflare Pages、Netlify、Vercel、またはガイダンスのみ。
リクエストが十分に明確であれば、先に進みます。複数のルートが非常に異なる作業を生み出す場合にのみ、簡潔な質問をします。
ルーター
ユーザーの現在の状態に基づいてワークフローを選択します:
- 漠然としたアイデア、または「スタイルを見つけて」:
search-blog-themeを使用し、オリジナルビルドの前にfind-style-referencesを使用します。 - 選択された方向性があり、特定のターゲットサイトがない:
find-style-referencesを使用し、その後make-personal-siteを使用します。 - ターゲットURL/スクリーンショット/テンプレートが密接に一致する:
copy-website-styleを使用します。 - 既存の生成サイトで、まだプレースホルダーやコピーされた本人情報がある:
personalize-siteを使用します。 - 既存サイトに新しい記事/ノート/文書を追加:
add-blog-postsを使用します。 - 既存サイトに1つの小さなビジュアル/コピー/レイアウト/インタラクションの変更:
edit-site-partを使用します。 - 「このサイトをチェックして」「これで十分か」「公開前に」:
review-static-siteを使用します。 - 「デプロイ」「公開」「GitHub Pages」「Cloudflare Pages」「Netlify」「Vercel」:
review-static-siteの後にpublish-static-siteを使用します。
ユーザーが完全なワンクリックビルドを要求した場合、実際の入力を処理する最短のチェーンを選択します。存在するからといってすべての子スキルを実行してはいけません。
ルート例
これらの例を使用してルーティングを安定化します:
| ユーザーリクエストパターン | ルート |
|---|---|
| 「特徴的な個人ブログが欲しい、スタイルを選ぶのを手伝って」 | search-blog-theme |
| 「この選んだスタイルについて、ビルド前に実際の参考資料を見つけて」 | find-style-references |
| 「この選んだ方向性で個人サイトを作って」 | find-style-references -> make-personal-site -> review-static-site |
| 「完全な個人ブログをゼロから構築して」 | 必要に応じてsearch-blog-theme -> find-style-references -> make-personal-site -> コンテンツがあればpersonalize-site -> review-static-site |
| 「このURLを参考にして再現して」 | copy-website-style -> personalize-site -> review-static-site |
| 「このウェブサイトをコピーして、その人のコンテンツを自分のに置き換えて」 | copy-website-style -> personalize-site -> review-static-site |
| 「これが生成されたサイトです。プレースホルダーを自分の経歴/プロジェクト/リンクに置き換えて」 | personalize-site -> review-static-site |
| 「このMarkdown/Obsidian/Wordの記事をサイトに追加して」 | add-blog-posts -> review-static-site |
| 「この1つのセクション/色/タイトル/カード/メニューを変更して」 | edit-site-part; 共有構造やアセットが変更された場合のみreview-static-siteを追加 |
| 「このサイトが準備できているか確認して」 | review-static-site |
| 「これをCloudflare Pages/GitHub Pages/Netlify/Vercelにデプロイして」 | review-static-site -> publish-static-site |
| 「HTTPではローカルで動作するが、index.htmlをダブルクリックすると動作しない」 | review-static-site; 公開前にパスゲートの失敗を修正 |
標準パイプライン
アイデアからオリジナルサイトへ
ユーザーが大まかな目標やスタイルの好みしか持っていない場合に使用します。
- ビジュアルの方向性が不明瞭な場合は
search-blog-theme。 - 選択された方向性を実際のウェブサイト/テンプレート/スクリーンショットに基づかせるための
find-style-references。 - 静的サイトを作成するための
make-personal-site。 - ユーザーが本人情報/コンテンツを提供した場合、またはサイトに埋めるべきプレースホルダーがある場合の
personalize-site。 - 厳格なQAゲートとしての
review-static-site。 - 公開が要求されていない限り、ローカルプレビュー手順で停止。
参考資料から個人サイトへ
ユーザーがターゲットURL、スクリーンショット、v0テンプレート、Figmaデザイン、または一致させる既存のウェブサイトを提供した場合に使用します。
- レイアウト、モーション、ページタイプ、インタラクションを再現するための
copy-website-style。 - ターゲットの本人情報とプレースホルダーコンテンツを置き換えるための
personalize-site。 - ユーザーが文章コンテンツを提供した場合の
add-blog-posts。 - 厳格なQAゲートとしての
review-static-site。 - 公開が要求されていない限り、ローカルプレビュー手順で停止。
コンテンツファーストブログ
ユーザーの最も強い入力が記事、ノート、Markdown、Wordファイル、または古い文章アーカイブである場合に使用します。
- サイト/テーマが存在しない場合のみ
search-blog-themeを使用。 - 新しいオリジナルのビジュアルシステムが必要な場合の
find-style-references。 - 静的サイトがまだ存在しない場合の
make-personal-site。 - 既存サイトの記事システムにコンテンツをインポートするための
add-blog-posts。 - 本人情報/プロフィールコンテンツが一般的なままである場合の
personalize-site。 - 厳格なQAゲートとしての
review-static-site。 - 公開が要求されていない限り、ローカルプレビュー手順で停止。
既存サイトの改善
ユーザーが既に生成されたサイトフォルダを持っている場合に使用します。
- サイトと、存在する場合は
EDITING.mdを検査。 - 本人情報/コンテンツの置き換えには
personalize-site。 - 記事インポートには
add-blog-posts。 - デザインやコピーの焦点を絞った変更には
edit-site-part。 - 変更がナビゲーション、ページタイプ、アセット、エンコーディング、公開準備、または複数ページに影響する場合は
review-static-site。
公開準備完了サイト
ユーザーが公開またはデプロイを要求した場合に使用します。
- 最初に
review-static-siteを使用。 - レビューで問題が見つかった場合、ブロッカーを修正するか、関連する子スキルにルーティング。
- サイトが必要なローカルチェックに合格するか、ユーザーが既知のリスクを受け入れた後にのみ
publish-static-siteを使用。 - デプロイが発生した場合、ライブURLを確認。
品質ゲート
関連するゲートに合格するか、ユーザーが明示的な制限を受け入れるまで、ワークフローは完了しません。
テーマゲート:
- ビジュアルの方向性または参考資料は、ビルド可能なほど具体的である。
- ビルドがオリジナルで好みの言葉に基づく場合、実際のスタイル参考資料が複数の角度から検索され、可能な場合は少なくとも3つの強い参考資料が調査されているか、ユーザーがそのステップを明示的に放棄している。
- 選択されたアプローチがユーザーのサイトタイプ(ブログ、ポートフォリオ、研究ホームページ、デジタルガーデン、ノート、リンク、またはハイブリッド)と一致する。
構造ゲート:
- 必要なページタイプが存在し、ホームページだけでない。
- ブログのようなサイトには、少なくとも1つの記事/詳細ページとリスト/アーカイブのエントリポイントが含まれる。
- ナビゲーションが実際の生成ページを指している。
コンテンツゲート:
- ユーザーが提供した本人情報/コンテンツが意図された場所に表示される。
- プレースホルダーのみのコンテンツは明確にマークされるか、置き換えられている。
- コピーされたソースサイトの本人情報は、ユーザーが所有しているか許可を得ていない限り、スタイル再現から削除されている。
パスゲート:
- サイトローカルのリンクとアセットは、デフォルトでページ相対である。
- ネストされたページは正しい
../深さを使用する。 - HTML、CSS
url(...)、JavaScript生成リンク、データファイル、カバー画像、フォント、ベンダーアセットが、偶発的なルート絶対パスを避けている。 - 直接
index.htmlを開いても、CSS、JS、画像、ナビゲーションが失われない。
エンコーディングゲート:
- UTF-8ソースファイルはUTF-8として提供されている(BOMなしUTF-8、Latin-1やその他のバイトマングリングではない)。
- HTMLの
<meta charset="utf-8">または<meta charset="UTF-8">が存在する。 - 画像や非テキストファイル以外にバイトマングリングがない。
運用手順(続き)
ルーティングは決定的であること。すべてを実行しない。
サイレントエラーを避ける。子スキルが失敗した場合、次のスキルに進む前に報告する。自動修正が可能な場合(例:パスタイプの修正)のみ、ゲートの不具合をサイレント修正する。
ゲートの失敗はブロッカーである。それらを無視してはいけない。自動修正ができない場合、ゲートを最小の責任子スキルにルーティングする。
review-static-siteは常に最新の出力を検査する。ビルド、編集、パーソナライズ、インポートが必要な場合、最初にそれを実行し、その後レビューする。
サイトは完全に静的でなければならない。node_modules、package.json、またはフレームワーク特有の構成をデフォルトで含めてはいけない。ユーザーが明示的にそのスタックを要求した場合にのみ追加する。
「ここから次へ」の対処
ユーザーが既存のサイト生成またはワークフローの途中で「次は何?」と尋ねた場合:
- 現在のサイトフォルダに
EDITING.mdが存在するか確認する。存在する場合、それを読み取り、状態を決定するための主要な情報源として使用する。EDITING.mdには、どの子スキルが実行されたか、どのアセットが追加されたか、どのゲートに合格/不合格になったか、どのプレースホルダーが残っているかが含まれている必要がある。 - サイトフォルダと
EDITING.md(存在する場合)を検査し、不完全なゲートを特定する。 - 失敗したゲートを最小の責任子スキルにルーティングし、以下の優先順位で実行する(すべてではない):
- パスゲート(壊れたリンクは他のすべてのゲートを無効にする)
- 構造ゲート(欠落しているページはコンテンツをインポートする場所をなくす)
- コンテンツゲート(プレースホルダーは最悪のUXである)
- エンコーディングゲート(まれだが、他のすべてのゲートを壊す可能性がある)
- 未解決のゲートがない場合、ユーザーに現在の状態を次のアクションオプションとともに提示する。
「ここから次へ」ルートテーブル
| 現在の状態 | 推奨される次のステップ |
|---|---|
EDITING.mdなし、サイトフォルダなし、またはmake-personal-site/copy-website-styleの前 | search-blog-themeまたはfind-style-referencesを推奨。またはユーザーが何を望んでいるかを尋ねる。 |
make-personal-siteまたはcopy-website-styleの直後、未検証 | review-static-site。障害が自動修復できない場合のみpersonalize-site。 |
| 検証されたサイト、プレースホルダーなし、またはコンテンツインポート前 | add-blog-postsを推奨し、Markdownファイルや記事のソースを探す。 |
| インポートされたコンテンツ、未レビュー | review-static-site。その後、公開またはさらなる編集を推奨。 |
| 完全にレビューされ検証されたサイト、公開なし | publish-static-siteを推奨。ユーザーがプラットフォームを持っていない場合は、GitHub Pages、Cloudflare Pages、Netlify、Vercelのオプションを尋ねる。 |
| 公開済み | 変更を行うにはedit-site-partを推奨。新しいコンテンツを追加するにはadd-blog-posts。 |
ユーザーインタビューのパターン
これらの例を使用して、情報収集を簡潔かつ効果的に保ちます:
- 「新しい個人サイトを作成しますか、それとも既存のものを編集しますか?」
- 「私があなたのためにサイトのスタイルを選ぶべきですか、それとも私がコピーするための参考URLまたはスクリーンショットをあなたは持っていますか?」
- 「あなたの名前と1行の経歴を教えてください。開始できます。」
- 「記事をインポートしますか?はいの場合、Markdownファイル、Obsidianボールト、またはWord文書をお持ちですか?」
- 「公開する準備はできていますか?もしそうなら、どのプラットフォーム(GitHub Pages、Cloudflare Pages、Netlify、Vercel)ですか?」
- 「コンテンツの変更は1ページだけですか、それともサイト全体に影響しますか?」
複数のルートが同様に妥当な場合、1つを推奨し、代案を提供します。「サイトの方向性を探すところから始めて、後で参考資料を調べることができます。または、お気に入りのウェブサイトのURLがあれば、それを再現することもできます。」