Communitygithub.com

Personal Site Builder — 履歴書から個人サイトへ

履歴書、SNS、ポートフォリオ、日々のアウトプットをデプロイ可能な静的個人サイトに。ヒアリングで根拠を確認し、目的×内容の深さで情報設計、6種のビジュアルスタイル(参考サイトからの抽出も可)で生成、ブラウザ検収、許可を得てからデプロイ。

Personal Site Builder — 履歴書から個人サイトへ とは?

Personal Website レシピ Step 1(構成):spacezephyr-personal-site-builder。内容→構造→ビジュアル→コードの順で、経歴を捏造せずプライバシーを保護。Cloudflare Pages / Vercel / GitHub Pages 向けの純静的 HTML/CSS/JS を出力し、About ページと link-in-bio ハブへ渡す。

対応✓Claude Code~Codex CLI~Cursor
npx skills add SpaceZephyr/personal-site-builder

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

個人サイトビルダー

「1枚の履歴書 + 多数のリンク + 散らばった成果物」を、情報構造があり、視覚スタイルがあり、そのままデプロイ可能な静的サイトに変換します。

成果物:純粋な静的HTML/CSS/JS(ビルド不要、フレームワーク不要、単一ファイルCSS)。Cloudflare Pages / Vercel / GitHub Pagesに直接デプロイ可能。

コア原則

  • 順序を逆転させない:コンテンツ → 構造 → ビジュアル → 最後にコード。最初からテンプレートを当てたり、色やフォントを質問しない。
  • 4つの情報タイプを区別する:ユーザー確認済みの事実 / ソース原文の要約 / AIが起草したコピー / 未確認の推論。経歴、数字、顧客、評価、身分、協力関係を捏造しない。
  • プライバシーをデフォルトで保護する:公開電話番号、住所、プライベートメール、顧客資料の公開は個別に確認が必要。
  • テンプレートを埋めるために空のセクションを作らない:資料が足りなければ内容の深さを下げるか、欠落項目をリストアップする。プレースホルダーの事例で埋めない。
  • 推奨付きの選択肢を提示する:各決定ポイントで実質的に異なる2~3の案と明確な推奨を提示し、選択をすべてユーザーに任せない。
  • デプロイは対外向け公開アクション:ユーザーの明確な許可を得た場合のみ実行する。

ワークフロー

① 境界設定 → ② 資料収集 → ③ 情報階層決定 → ④ 視覚スタイル決定 → ⑤ 生成 → ⑥ 検収 → ⑦ 許可後デプロイ

① 境界設定

最初に新規作成か既存サイトの改造かを判断する。

  • プロジェクトがある場合:まずディレクトリ構造、既存ページ、コンテンツソース、ビルドコマンド、デプロイ設定、git状態を読み、既存の技術スタックとデザイン制約を継承する。新しいものを作り直さない。
  • 新規作成の場合:デフォルトで軽量レスポンシブ静的サイト。CMS、ログイン、動的データが本当に必要な場合のみ、フレームワークやバックエンドを導入する。

その後、方向性を決める質問を1つだけする:

「このサイトは主に誰に見せるのか? 見た後に何をしてほしいのか?」

この段階では色、フォント、アニメーションについて質問しない。

② 資料収集

references/intake.md(最小限の開始資料、段階的な質問順序、コンテンツエンティティのフィールド、証拠のグレード、プライバシールール、取得可能なソース一覧を含む)を読む。

ポイント:

  • 最初の返信は軽くする。ユーザーが既に何を持っているか言っているので、最初の返信ではそれを送ってもらうだけにする。最初のバッチを読んだ後に次の質問をする。毎回、次のステップに最も影響を与える質問を1つだけ行い、十数ものフォームを一度に送信しない。
  • 読めるものは先に読む、質問しない。履歴書(Read / docx / pdf skill)、GitHub、ブログ、微信公衆号(WeChat Official Account)の記事(WebFetch)、ログインが必要なプラットフォーム(claude-in-chrome)。ログイン壁、CAPTCHA、スクレイピング対策に遭遇したらすぐに停止し、代わりにエクスポートファイル、テキスト、リンクリスト、スクリーンショットをユーザーに提供してもらう。
  • 数字は形容詞より優先され、検証可能な表現のみを使用する。「10製品、5万ユーザー、200近いSkill」は「経験豊富」より優れている。検証できないものは推定値を補わない。
  • クロスプラットフォームの重複コンテンツは1つのコンテンツエンティティに統合し、複数のソースリンクを保持する。情報が矛盾する場合は、ユーザーが確認できるように両方のバージョンを保持する。

収集後、資料一覧確認(既存 / 未確認 / 欠落 / 推奨補足)を出力し、ユーザーが確認した後に次のステップに進む。

③ 情報階層決定

references/architectures.mdを読む。二軸で決定する:

軸1:サイト目標(主要目標1つを選択。最大で副次目標1つ追加可能)

ユーザー資料の主な内容主要目標
職務経歴、スキル、学歴、転職希望求職コンバージョン
プロジェクト / デザイン / 写真 / 動画、ビジュアル素材が多いポートフォリオ展示
人生のストーリー + 興味 + 価値観、完成品が少ない自己紹介
長期間書いてきた記事 / 読んだ本 / 歩んできた道、アーカイブしたい長期記録
コンサルティング、執筆依頼、指導、仕事の依頼を受けたいコンサルティング顧客獲得
微信公衆号 / X / 小紅書 / ポッドキャスト、フォロワーとコンテンツアセットがあるクリエイターページ
製品やオープンソースプロジェクトをリリースしたことがあり、それを使ってほしい/買ってほしいインディーデベロッパー

軸2:コンテンツの深さ(資料の量で決まり、願望では決まらない)

  • L1 名刺レベル — 単一ページ。身分 / ポジショニング / メインアクション / 3つの代表リンクのみ。資料が少ない、または迅速な立ち上げが必要。
  • L2 証明レベル — トップページ + プロジェクト/経験の詳細ページ。個人の貢献、プロセス、結果、メディア素材が必要。
  • L3 コンテンツシステムレベル — トップページ + 詳細 + カテゴリインデックス + アーカイブ + 継続的更新メカニズム。安定したコンテンツソースと更新意欲が必要。

資料がL2をサポートできない場合は、まずL1にする。継続的な更新能力がなければL3を選択しない。

architectures.mdのテンプレートに従って、実質的に異なる2〜3の案(違いは訪問者のタスクに基づく必要があり、単なるセクション名の変更ではならない)を出力する。各案には以下を明記:誰に適しているか / ファーストビューの約束 / メインアクション / ナビゲーション / トップページの順序 / 使用する既存素材 / 他に補う必要があるもの / 主なトレードオフ。明確に1つを推奨し、ユーザーが確認した後にビジュアルに進む。

④ 視覚スタイル決定

まず質問:「好きなウェブサイトやデザインはありますか? あればリンクやスクリーンショットを送ってください。」 ユーザーが形容詞から選ぶよりも、参考例がある方がはるかに正確。

3つのパス、ユーザーが持っているものに応じて選択:

  1. ユーザーが参考URL / スクリーンショット / デザイン仕様を提供した場合 → references/style-extraction.mdを読む。まずclaude-in-chromeで参考サイトを開き、その中のスクリプトを実行して実際のcomputed style(フォントスタック、色値、角丸、シャドウ、コンテナ幅)をサンプリングする。明るいテーマと暗いテーマの両方をサンプリングする。開けない場合やログインが必要な場合は、スクリーンショット分析に切り替える。雰囲気を抽出し、サイト全体をクローンしない。ロゴ、コピー、イラスト、独自のレイアウトを取らない。
  2. ユーザーがブランド名を指定した場合(「Notionのような感じ」「Apple風」)→ brand-design-md skillを呼び出してDESIGN.mdを取得し、site.cssの:root変数にマッピングする。
  3. ユーザーに参考例がない場合 → references/visual-styles.mdを読み、6つの内蔵スタイルから2〜3の方向性と推奨理由を提示する。それぞれに直接貼り付け可能なCSS変数値を含める。

ユーザーが複数の参考サイトを提供した場合、まず「どのサイトの雰囲気が一番欲しいですか? 他のサイトで具体的に好きな点はどこですか?」と質問する。多くの人はAのレイアウト + Bの配色が好きだが、直接交差させると4不肖(何にも似ていない)になる。

ユーザーがWordPress / Framer / Webflow / Notionに言及した場合、その情報整理と雰囲気を参考にするだけで、対応するプラットフォームのテーマやプロジェクトを生成したふりをしない。

どのパスを選んでも、最後は:root変数のみを変更し、site.cssのコンポーネント部分を書き換えない。選択後にコードを書く。

⑤ サイト生成

最初にassets/starter/をコピー:

  • site.css — CSS変数 + タイポグラフィベースライン + カード/リストコンポーネント、明るい/暗いデュアルテーマ。スタイル変更 = :root変数の変更。ファイル全体を書き換えない。
  • nav.js — 単一ファイルで注入される固定トップバー(ダークモード切り替え + スクロールによる非表示)。上部設定領域でSITE_NAME / LINKS / THEME_KEYを変更。そのインラインCSS内の760pxは、site.cssの--maxと一致させる必要がある。
  • index.html — トップページのスケルトン。セクションは案に応じて追加/削除。

以下の条件を満たす必要がある:

  • ファーストビューに本人の名前または一般的な呼称 + ポジショニング + 1つのメインアクションが表示される。メインアクションは1つだけ、サブアクションは最大1つ。
  • ナビゲーションは確認済みの情報アーキテクチャを反映し、プラットフォームテンプレートのセクションをそのままコピーしない。項目数は4〜6。
  • 作品は問題 / 自分の役割 / やり方 / 結果を優先的に説明し、サムネイルだけを載せない。
  • ソーシャルリンクはそのプラットフォームで何が見られるかを説明し、単なるアイコンの羅列にしない。
  • 各ページは独立したxxx/index.htmlで、/site.cssと/nav.jsを共有。CDN、フレームワーク、ビルド手順を導入しない。
  • <title>、<meta name="description">、favicon、共有画像が完全。外部リンクはtarget="_blank" rel="noreferrer"。
  • デスクトップ + モバイルでスムーズに閲覧可能。キーボードで主要フローを完了可能。セマンティック構造とaltが完全。prefers-reduced-motionをサポート。
  • 画像は実際の作品/人物/スクリーンショットを使用。画像がない場合はまず素材を要求。生成された画像は生成素材であることを明記する必要がある。
  • 「これは私の個人サイトです」「以下は私の作品です」などのプロンプトをデザインとして使用しない。

中国語タイポグラフィ:行高 ≥ 1.7、段落間隔 ≥ 18px、フォントスタックにPingFang SCを残す。より強力なフロントエンドデザイン能力が必要な場合は、frontend-design skillを呼び出す。

⑥ 検収

references/delivery-checklist.mdを読み、項目ごとに確認する。少なくとも以下を検証:

  • トップページ、ナビゲーション、詳細ページ、外部リンク、メインアクション
  • 360 / 390 / 768 / 1280 / 1440 の5つの幅
  • 最長の名前とタイトルがオーバーフローしない。空のコンテンツ、画像読み込み失敗、外部リンク切れの表示
  • コンソールに使用に影響するエラーがない。予期しない横スクロールとレイアウト重複がない
  • 明るい/暗い両方のテーマで読み取り可能(コントラスト ≥ 4.5:1)
  • サイト内に残っているTODOプレースホルダー、架空の数字、テストリンクがない
  • 公開情報がユーザー確認済みのリストと一致している

python3 -m http.serverでローカルプレビューを起動するか、claude-in-chromeでスクリーンショットを撮り、ユーザーが公開前に確認できるようにする。

⑦ 許可後デプロイ

まずどこに公開するか、公開するかどうか、どのリポジトリ/アカウントを使用するか、どのドメインや環境変数を変更するかを説明し、明確な許可を得てから実行する。

  • 既存プロジェクトは既存のデプロイ方法を継承。新しい静的サイトは優先的にCloudflare Pages / Vercel / GitHub Pages(ビルドコマンドは空白、出力ディレクトリはサイトルート)。
  • まずビルド → 次に公開 → その後本番URLにアクセスして主要コンテンツを検証。プレビュー成功 ≠ カスタムドメインの反映。
  • キー、履歴書の原本、プラットフォームのエクスポートデータをサイトにパッケージ化しない。

最終納品説明

簡潔にリストアップ:選択した目標とコンテンツの深さ / 実装したページと主要コンテンツ / アクセスURL / 検証結果 / まだ公開していない、または補足が必要なコンテンツ。長い説明で未完了のコード、検収、デプロイを隠さない。

禁止リスト

  • ❌ トップページにすべてのコンテンツを詰め込む — ファーストビューの3秒で「あなたは誰 + 何ができるか + どうやって連絡するか」を明確にし、残りはすべてダウングレード
  • ❌ 「技術に情熱を持ち、卓越性を追求する」のような空文句 — 検証可能な事実と数字に置き換える
  • ❌ ユーザーが提供していないのに、経歴、プロジェクト、数字、顧客評価を代わりに作る
  • ❌ 一度に十数もの質問をする。または、資料確認と案確認をスキップして直接コードを書く
  • ❌ 資料が足りないのに無理にL3に上げ、空のブログやプレースホルダーの事例で体裁を整える
  • ❌ 複雑なアニメーション、グラデーションの積み重ね、セクションごとに異なるフォント — 個人サイトの信頼性は抑制から生まれる
  • ❌ 参考サイト全体をダウンロードして名前を変更する — 抽出するのは配色/タイポグラフィ/スペーシングの雰囲気であり、ロゴ、コピー、イラスト、独自のレイアウトではない
  • ❌ 許可なくpush / デプロイ / 連絡先を公開する

関連スキル