Communitygithub.com

tangshengming/personal_website

CVやプロフィール情報から構造化コンテンツを抽出し、レビュー可能なMarkdownソースファイルを作成、プライバシーやデザインの決定を確認し、Astroウェブサイトをスキャフォールディングしてローカルで検証する、ファースト個人ウェブサイトを生成します。ユーザーがウェブサイト生成、CVからの個人ウェブサイト構築、PDF/LaTeX CVのポートフォリオサイトへの変換、またはCVからウェブサイトへのワークフローの再現を依頼した場合に使用します。

personal_website とは?

このスキルは、CVやプロフィールソースから個人ウェブサイトを生成するための包括的なワークフローを提供します。主な特徴は、ウェブサイトのページを生成する前に、まずCVをMarkdownに抽出し、公開・非公開の判断を確認し、構造化されたコンテンツからサイトを構築するという段階的なアプローチです。対応しているプラットフォームはAstro(デフォルト)で、PDF、LaTeX、DOCXなど様々なCVソース形式を処理できます。ワークフローは、ワークスペースの検査、CVの読み取りと検査、レビュー可能なMarkdownへの抽出、プライバシー設定の確認、サイト構造のドラフト作成、Astroサイトのスキャフォールディング、ローカルでの検証、そしてステータスファイルの更新という9つのステップで構成されています。このスキルは、個人情報の取り扱いに慎重であり、デフォルトで電話番号や生年月日などの機密情報を非公開とし、ユーザーの明示的な同意を得て公開するように設計されています。また、生成されたサイトは、最初の画面に実際のアイデンティティとプロフィールを表示し、マーケティング的なランディングページではない点が特徴です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/generate-website

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

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

ドキュメント

ウェブサイトの生成

概要

このスキルを使用して、慎重なCVからウェブサイトへのワークフローを再現します。重要な原則は、ページを生成する前にレビュー可能なソースマテリアルを作成することです。最初にCVをMarkdownに抽出し、次に何を公開するかを決定し、最後に構造化されたコンテンツからウェブサイトを構築します。

ワークフロー

1. ワークスペースの検査

編集前に現在のプロジェクトファイルを確認します。

  • WEBSITE_WORKFLOW.md、PROJECT_STATUS.mdなどのワークフロー/ステータスファイルを探します。
  • CV/プロフィールのソースファイルを見つけます。通常は.pdf、.tex、.docx、またはテキスト/MarkdownのCVです。
  • ウェブサイトがすでに存在するかどうかを確認します:package.json、astro.config.*、src/、public/、dist/。
  • 必要に応じてgit status --shortでGitの状態を軽く確認します。

空のプロジェクトを想定しないでください。

2. CVの読み取りと検査

ソースがPDFの場合:

  • PDFスキルを使用します。
  • pdfplumberまたは他の信頼性の高いPDFテキストツールでテキストを抽出します。
  • 可能であればページを画像にレンダリングし、視覚的に検査してレイアウトやセクションの境界を見誤らないようにします。
  • PDFテキスト抽出にはスペースやアイコンのアーティファクトがあることを想定し、構造化出力で手動でクリーニングします。

ソースがLaTeXの場合:

  • .texソースを直接読み取ります。
  • セクションコマンド、マクロ、リストを構造として扱います。
  • ユーザーがPDFの再生成を要求しない限り、ローカルでのLaTeXコンパイルは必要ありません。

ソースが.docxの場合:

  • ドキュメントスキルを使用して構造とコンテンツを抽出します。

3. レビュー可能なMarkdownへの抽出

ウェブサイトページを構築する前にMarkdownソースファイルを作成します。推奨:

content/cv_extracted.md

次のような構造化セクションを含めます:

  • アイデンティティ
  • 公開連絡先
  • 非公開または非表示の連絡先/詳細
  • プロフィール
  • 言語
  • 技術的専門知識
  • プロフェッショナルスキル
  • 職務経験
  • 学歴
  • 出版物
  • プロジェクト
  • 各プロジェクトのウェブサイト上でのプレゼンテーションの可能性

このファイルは事実ベースに保ちます。これはソースマテリアルであり、最終的なマーケティングコピーではありません。

4. 公開/非公開の決定を質問または確認

個人の詳細を公開ウェブサイトに掲載する前に、以下を確認します:

  • 公開メールアドレス
  • 電話番号を表示するかどうか
  • 生年月日を表示するかどうか
  • 完全な住所を表示するかどうか
  • 居住地/許可/ビザ/運転免許の詳細を表示するかどうか
  • 公開または非表示にするリンク:GitHub、LinkedIn、Google Scholar、ORCID、ResearchGateなど
  • 対象読者の希望:業界、学術、混合、クライアント、リクルーター、共同研究者
  • ビジュアルの好み:ミニマル、アカデミック、表現力豊かな技術ポートフォリオなど

デフォルトのプライバシーポリシー:

  • ユーザーが明示的に公開を希望しない限り、生年月日、電話番号、完全な住所、居住許可、運転免許証、および同様の機密情報は非表示にします。
  • 公開メールアドレス、市区町村/国、および選択されたプロフェッショナルリンクを優先します。

5. ウェブサイト構造のドラフト作成

スキャフォールディングやページの大幅な編集を行う前に、構造ドラフトを作成します。推奨:

WEBSITE_STRUCTURE_DRAFT.md

以下を含めます:

  • デザインの方向性
  • 対象読者
  • ナビゲーション
  • ページリスト
  • ページの目的
  • ページごとの推奨コンテンツ
  • 未解決の質問や決定事項
  • 技術的な推奨事項

優れた最初の構造の例:

  • ホーム
  • 概要
  • CV
  • プロジェクト
  • お問い合わせ

研究重視のプロフィールの場合は、後でアカデミックなウェブプレゼンテーションページのための余地を残します。

6. ウェブサイトのスキャフォールディング

ユーザーが他のスタックを要求しない限り、コンテンツ量の多い個人ウェブサイトにはデフォルトでAstroを使用します。

推奨構造:

src/
  pages/
    index.astro
    about.astro
    cv.astro
    projects.astro
    contact.astro
  content/
    profile.ts
    projects.ts
  layouts/
    BaseLayout.astro
  styles/
    global.css
public/

ウェブサイトコンテンツは、ハードコードされたCVテキストをあちこちに散りばめるのではなく、構造化されたソースファイルから構築します。

推奨コンテンツファイル:

  • src/content/profile.ts:アイデンティティ、プロフィール、専門知識、経験、学歴、出版物用。
  • src/content/projects.ts:プロジェクトエントリーと後で追加するプレゼンテーションノート用。

公開アセットをpublic/にコピーします:

  • CV PDF(ユーザーがダウンロード可能なCVを希望する場合)。
  • 肖像写真(利用可能で承認されている場合)。
  • プロジェクトの画像や図(後で追加)。

7. 最初のバージョンのデザイン

ファースト個人サイトの場合:

  • 最初の画面は、マーケティング用のランディングページではなく、実際のアイデンティティ/プロフィールにします。
  • 利用可能な場合は実際のビジュアルアセットを使用します。
  • 連絡先情報はプライバシーに配慮したものにします。
  • 素早くスキャンできるが、後で拡張できるページを構築します。
  • 業界向けの読者には、エンジニアリングの有用性、研究開発ワークフロー、技術的な深さ、移行可能な能力を強調します。
  • アカデミックな読者には、研究課題、方法、出版物、プレゼンテーションの流れを強調します。

最初のバージョンを過剰に適合させないでください。将来のプロジェクトプレゼンテーションページのために明確な場所を残します。

8. ローカルで検証

実行:

npm.cmd install
npm.cmd run build
npm.cmd run dev

Windows/PowerShellでは、npmがスクリプト実行ポリシーでブロックされている場合は、npm.cmdを優先します。

Astroテレメトリーがワークスペースの外部に書き込もうとする場合は、package.jsonのスクリプトを次のように設定します:

"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"

確認:

  • ビルドが成功すること。
  • ローカルルートが200を返すこと。
  • 公開アセットが読み込まれること。
  • 機密情報が誤って表示されていないこと。
  • ブラウザでの視覚的なQAが可能な場合は実行するか、ユーザーが手動でレビューすること。

9. ステータスファイルとReadmeファイルの更新

プロジェクトが使用している場合は、ステータス/ダッシュボードファイルを更新します。例:

PROJECT_STATUS.md

便利なサポートファイル:

  • readme_website.txt:ウェブサイトの編集、プレビュー、ビルド、コミット方法。
  • readme_git.txt:Gitのセットアップと一般的なコマンド。
  • WEBSITE_WORKFLOW.md:長期的なワークフロー。

ステータスは簡潔に保ちます。ユーザーが尋ねない限り、ノイズの多いGitの詳細は追加しないでください。

出力の期待値

最初のパスの終了時点で、プロジェクトには以下が含まれている必要があります:

  • 抽出されたCVソースMarkdown。
  • ウェブサイト構造のドラフト。
  • 動作するAstroサイト。
  • ページ/レイアウトコードから分離されたコンテンツ。
  • 成功したビルド。
  • ローカルプレビューURL。
  • 保留中の事項に関する明確なメモ。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル