フロントエンド履歴書
依存関係ゼロ、アニメーション豊かなHTML履歴書ページを作成します。ブラウザだけで完全に動作します。視覚的な探索を通じてユーザーが好みの美観を発見し、本番品質のインタラクティブな履歴書を生成できるように支援します。
基本理念
- 依存関係ゼロ — インラインCSS/JSを使用した単一HTMLファイル。npmもビルドツールも不要。
- 見せること、語らないこと — ビジュアルプレビューを生成し、ユーザーに好きなものを選んでもらいます。
- 特徴的なデザイン — ありきたりな「AI生成」的な美観は避けます。各履歴書はカスタムメイドであるべきです。
- 印刷対応 — すべての履歴書には、クリーンなPDF出力のための
@media printスタイルを必ず含めます。 - アクセシブル — セマンティックHTML、キーボードナビゲーション、動きの軽減対応、WCAG AAコントラスト。
フェーズ0: モード検出
ユーザーの希望を判断します:
モードA: ファイルから — ユーザーが履歴書ファイル(.pdf、.docx、.md、.txt、.json)を提供 → フェーズ1へ モードB: テキストから — ユーザーが履歴書の内容をテキストで提供 → フェーズ1へ モードC: 拡張 — ユーザーが既存のHTML履歴書を持っている → ファイルを読み込み、フェーズ2へ
フェーズ1: コンテンツ抽出と構造化
ステップ1.1: ファイル抽出(モードAのみ)
ユーザーの履歴書ファイルに対して scripts/extract_resume.py を実行します:
python [skill-dir]/scripts/extract_resume.py <resume_file>
サポートされるフォーマットと依存関係:
| フォーマット | 拡張子 | Python依存関係 | 備考 |
|---|---|---|---|
pdfplumber(推奨)または PyPDF2 | pip install pdfplumber | ||
| Word | .docx | python-docx | pip install python-docx |
| Markdown | .md | なし | 見出し、リスト、太字/斜体を解析 |
| プレーンテキスト | .txt | なし | すべて大文字の行を見出しと推定 |
| JSON Resume | .json | なし(組み込み json) | jsonresume.org スキーマ; すでに構造化済みのため、ステップ1.2をスキップ可能 |
必要な依存関係がない場合、スクリプトはインストール手順を表示します。
抽出されたコンテンツを確認のためにユーザーに提示します。JSON Resumeファイルの場合、データはすでに構造化されているため、ユーザーが調整したい場合を除き、マッピングされたセクションを直接提示してステップ1.3に進みます。
ステップ1.2: コンテンツの構造化
生のテキストを構造化されたセクションにパースします:
- header: 名前、肩書/タグライン、所在地、連絡先(メール、電話、LinkedIn、GitHub、ポートフォリオ)
- about: プロフェッショナルサマリー
- experience[]: 会社名、役職、期間、所在地、箇条書き
- education[]: 学校名、学位、期間、表彰/GPA
- skills{}: カテゴリ別にグループ化、オプションの習熟度(0-100)
- projects[]: プロジェクト名、説明、使用技術、リンク
- certifications[]: 認定名、発行機関、日付(オプション)
- languages[]: 言語、習熟度(オプション)
構造化された内容を確認のためにユーザーに提示します。「これは正しいでしょうか?追加、削除、または変更するセクションはありますか?」と尋ねます。
ステップ1.3: セクションの優先順位
AskUserQuestionで質問:
- ヘッダー: 「レイアウト」
- 質問: 「どのセクションを最も目立たせたいですか?」
- オプション:
- 「経験重視」 — 職歴を中心に(シニアプロフェッショナル向け)
- 「スキル重視」 — 技術スキルを前面に(開発者/エンジニア向け)
- 「プロジェクト重視」 — ポートフォリオ/プロジェクトを強調(デザイナー/フリーランサー向け)
- 「バランス」 — 全セクションに均等な重み
フェーズ2: スタイル発見
ステップ2.0: スタイルパス
質問: 「履歴書のスタイルはどのように選びたいですか?」
- 「オプションを見せて」 — 3つのビジュアルプレビューを生成(推奨) → ステップ2.1へ
- 「何が欲しいかわかっている」 — プリセットリストから直接選択 → 以下のプリセットピッカーを表示
利用可能なプリセット:
| プリセット | 雰囲気 | 最適な対象 |
|---|---|---|
| Midnight Architect | 洗練された、高級感 | エグゼクティブ、コンサルタント |
| Neon Terminal | ハッカー風、デベロッパー向け | ソフトウェアエンジニア、DevOps |
| Dark Luxe | エレガント、エディトリアル | クリエイティブディレクター、マーケティング |
| Cosmic Depth | 大胆、未来的 | テックファウンダー、AI/MLエンジニア |
| Clean Slate | ミニマル、スイスデザイン風 | デザイナー、プロダクトマネージャー |
| Paper Craft | 温かみのある、触感的 | ライター、教育者、アカデミック |
| Soft Blueprint | 技術的、親しみやすい | エンジニア、データサイエンティスト |
| Brutalist Mono | 生々しい、反デザイン | ブランドストラテジスト、目立ちたい人 |
| Sage Garden | 自然から着想、落ち着いた | HR、ウェルネス、教育者 |
| Retro Ink | ビンテージエディトリアル | ジャーナリスト、パーソナルブランド |
ユーザーが直接選択した場合、フェーズ3にスキップします。
ステップ2.1: ガイド付き発見
質問1 — ムード(複数選択可、最大2つ):
- 「プロフェッショナル/権威的」 — 確立された、信頼できる
- 「クリエイティブ/個性的」 — ユニーク、デザイン重視
- 「モダン/技術的」 — クリーン、開発者向け
- 「温かみ/親しみやすい」 — フレンドリー、感じの良い
質問2 — トーン:
- 「明るい」 — クリーン、印刷向き
- 「暗い」 — 大胆、画面最適化
- 「どちらでも」 — スタイルに任せる
ステップ2.2: 3つのプレビューを生成
ムードとトーンに基づいて、3つのプリセットを選択します。references/STYLE_PRESETS.md で完全なプリセット定義を参照してください。
ムードからプリセットへのマッピング:
| ムード | 暗い | 明るい | スペシャリティ |
|---|---|---|---|
| プロフェッショナル | Midnight Architect, Dark Luxe | Clean Slate, Soft Blueprint | — |
| クリエイティブ | Dark Luxe, Cosmic Depth | Paper Craft | Brutalist Mono, Retro Ink |
| モダン/技術的 | Neon Terminal, Cosmic Depth | Soft Blueprint | Brutalist Mono |
| 温かみ | Dark Luxe | Paper Craft, Sage Garden | Retro Ink |
.claude-design/resume-previews/ に3つのミニHTMLプレビューを生成:
.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html
各プレビュー: 自己完結型(約80〜120行)、ヒーローセクション + 1つの職歴エントリ + スキルバーを表示。美観を伝えるのに十分な内容。
これらのありきたりなパターンは絶対に使用しないでください:
- 表示用フォントにInter、Roboto、Arial
- 背景白に紫グラデーション、一般的なインディゴ
#6366f1 - すべて中央揃えでバリエーションなし
- 過剰なグラスモーフィズム
ステップ2.3: 選択
プレビューを提示し、ユーザーに1つを選んでもらうか、要素を組み合わせるか尋ねます。
フェーズ3: 履歴書の生成
選択されたプリセットに対して、以下のリファレンスファイルを読み込みます:
references/STYLE_PRESETS.md— 完全なCSS変数、フォントURL、カラーパレット、アニメーションスタイルreferences/RESUME_COMPONENTS.md— インタラクティブコンポーネントのCSS/JSパターンreferences/HTML_ARCHITECTURE.md— ベースHTMLテンプレート、必須CSS、JSアーキテクチャ、印刷スタイル、アクセシビリティチェックリスト
出力
自己完結型の単一HTMLファイルを生成:
- すべてのCSSは
<style>にインライン - すべてのJSは
<script>にインライン - Google Fonts / Fontshare は
<link>経由(グレースフルデグラデーション対応) - セマンティックHTML5構造
必須機能
- スクロールトリガー表示 — IntersectionObserver を使用して要素がアニメーション表示
- フローティングナビゲーション — アクティブセクションを追跡する固定ナビゲーション
- アニメーションスキルバー — スクロールでビューに入ると塗りつぶし
- スクロールプログレスバー — 上部の細いバー
- トップに戻るボタン — スクロール後に表示
- 印刷用スタイルシート — 白背景、アニメーションなし、URL表示可能な
@media print - 動きの軽減 —
@media (prefers-reduced-motion: reduce)でアニメーションを無効化 - レスポンシブ — すべてのサイズで
clamp()を使用、モバイルからデスクトップまで動作
確認チェックリスト
提供前に以下を確認:
- すべてのタイポグラフィで
clamp(min, preferred, max)を使用 - すべてのスペーシングで
clamp()またはビューポート単位を使用 - セマンティックHTML(
<header>、<main>、<section>、<nav>) - 印刷スタイルが含まれており機能する
- 動きの軽減が考慮されている
- ナビゲーション、ボタン、プログレスバーにARIAラベルが付与されている
- カラーコントラストがWCAG AAを満たしている
- 外部リンクに
target="_blank" rel="noopener"が設定されている
フェーズ4: デリバリー
- クリーンアップ —
.claude-design/resume-previews/が存在する場合は削除 - 開く — ブラウザで起動:
open [filename].html - サマリー:
インタラクティブな履歴書の準備ができました!
ファイル: [filename].html
スタイル: [Style Name]
セクション: [list]
機能:
- スクロールトリガーアニメーション
- アニメーションスキルバー
- インタラクティブタイムライン
- フローティングナビゲーション
- 印刷対応(Ctrl+P)
- すべての画面サイズでレスポンシブ
カスタマイズ方法:
- 色: 上部の:root CSS変数を編集
- フォント: フォントインポートリンクを変更
- アニメーション: .revealクラスのタイミングを変更
- コンテンツ: HTML内のテキストを直接編集
調整が必要な場合はお知らせください。
トラブルシューティング
PDF抽出でテキストが少ない場合: PDFが画像ベース(スキャン)である可能性があります。ユーザーにテキストコンテンツを直接提供してもらうよう依頼してください。
DOCX抽出で構造が欠落している場合: 一部のDOCXファイルは標準の見出しスタイル(Heading 1/2/3)を使用していません。抽出プログラムはフォールバックとして個々のフォントサイズを使用します。それでも構造が不明確な場合は、ユーザーにどの行がセクションヘッダーかを確認してもらってください。
JSON Resumeのフィールドが欠落している場合: JSONはオプションセクション(プロジェクト、資格など)を省略する場合があります。利用可能なものを提示し、ユーザーに不足しているセクションを手動で追加するか尋ねてください。
Markdownフロントマターの干渉: YAMLフロントマターのデリミター(---)は自動的にスキップされます。履歴書のコンテンツ自体が区切り線として --- を使用している場合もスキップされますが、通常は問題ありません。
フォントが読み込まれない場合: フォントURLを確認してください。font-family 宣言にシステムフォントのフォールバックが含まれていることを確認してください。
アニメーションがトリガーされない場合: IntersectionObserverが初期化されていることを確認してください。.visible クラスが追加されているか確認してください。
印刷出力がおかしい場合: @media print ブロックが存在することを確認してください。アニメーションが無効化され、背景が白になっているか確認してください。