Frontend Resume - 前端简历生成器 是做什么的?
创建零依赖、动画丰富的HTML简历页面,完全在浏览器中运行。帮助用户通过视觉探索发现自己的审美偏好,然后生成生产质量的交互式简历。
核心理念
- 零依赖 — 单个HTML文件,内联CSS/JS。无需npm,无需构建工具。
- 展示而非说教 — 生成视觉预览,让用户选择他们喜欢的风格。
- 独特设计 — 避免通用的“AI垃圾”美学。每份简历都应感觉像是定制的。
- 适合打印 — 每份简历必须包含
@media print样式,用于干净的PDF输出。 - 可访问性 — 语义化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:姓名、职称/标语、地点、联系方式(邮箱、电话、领英、GitHub、作品集)
- about:专业摘要
- experience[]:公司、职位、日期、地点、要点
- education[]:学校、学位、日期、荣誉/GPA
- skills{}:按类别分组,可选熟练度等级 (0-100)
- projects[]:名称、描述、技术栈、链接
- certifications[]:名称、颁发机构、日期(可选)
- languages[]:语言、熟练度(可选)
将结构化内容呈现给用户审核。询问:“这些看起来正确吗?需要添加、删除或修改任何部分吗?”
步骤 1.3:部分优先级
通过 AskUserQuestion 询问:
- Header:
- 问题:“哪些部分应该最突出?”
- 选项:
- “经验为主”——工作经历是亮点(高级专业人士)
- “技能重点”——技术技能放在首位(开发人员/工程师)
- “项目驱动”——作品集/项目亮点(设计师/自由职业者)
- “均衡”——各部分权重相同
阶段 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 行),展示英雄部分 + 一个经历条目 + 技能条。足以传达美学风格。
永远不要使用这些通用模式:
- Inter, Roboto, Arial 作为显示字体
- 白色背景上的紫色渐变,通用的靛蓝色
#6366f1 - 所有内容居中,没有变化
- 多余的玻璃态效果
步骤 2.3:选择
呈现预览,让用户选择其中一个或混合元素。
阶段 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>中 - 通过
<link>引入 Google Fonts / Fontshare(优雅降级) - 语义化 HTML5 结构
必需功能
- 滚动触发展开 — 元素通过 IntersectionObserver 动画进入
- 浮动导航 — 带有活动部分跟踪的固定导航
- 动画技能条 — 滚动到视图时填充
- 滚动进度条 — 顶部细条
- 返回顶部按钮 — 滚动后出现
- 打印样式表 —
@media print,白色背景,无动画,显示 URL - 减少动效 —
@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
风格: [风格名称]
部分: [列表]
功能:
- 滚动触发动画
- 动画技能条
- 交互式时间线
- 浮动导航
- 适合打印 (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 块。检查动画是否已禁用且背景为白色。