Communitygithub.com

Frontend Resume - 前端简历生成器

将简历转换为交互式、带有动画的单页HTML简历网站,拥有独特的视觉风格。支持PDF、DOCX、Markdown、纯文本、JSON Resume格式以及直接文本输入。

Frontend Resume - 前端简历生成器 是什么?

这是一个专门用于生成零依赖、动画丰富的单页HTML简历文件的AI Agent技能。它的核心价值在于通过视觉探索帮助非设计师用户发现自己的审美偏好,从而生成具有独特风格的简历。Agent的工作流程分为五个阶段:首先检测用户输入模式(文件、文本或增强现有HTML),然后提取并结构化简历内容,接着通过引导式问题或预设风格库让用户选择视觉风格(支持10种预设,如“Midnight Architect”、“Neon Terminal”等),并自动生成3个迷你预览让用户挑选。确认风格后,Agent会生成一个包含滚动触发动画、浮动导航、动画技能条、打印样式和无障碍支持(WCAG AA)的完整HTML文件。该技能支持Claude Code、Cursor、Codex等主要AI Agent平台,通过Python脚本(依赖pdfplumber、python-docx等)解析文件,最终输出一个可以直接在浏览器中打开、可打印、可分享的交互式简历。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yukiniro/skills/tree/HEAD/skills/frontend-resume

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Frontend Resume - 前端简历生成器 是做什么的?

创建零依赖、动画丰富的HTML简历页面,完全在浏览器中运行。帮助用户通过视觉探索发现自己的审美偏好,然后生成生产质量的交互式简历。

核心理念

  1. 零依赖 — 单个HTML文件,内联CSS/JS。无需npm,无需构建工具。
  2. 展示而非说教 — 生成视觉预览,让用户选择他们喜欢的风格。
  3. 独特设计 — 避免通用的“AI垃圾”美学。每份简历都应感觉像是定制的。
  4. 适合打印 — 每份简历必须包含 @media print 样式,用于干净的PDF输出。
  5. 可访问性 — 语义化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 依赖说明
PDF.pdfpdfplumber(首选)或 PyPDF2pip install pdfplumber
Word.docxpython-docxpip 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 LuxeClean Slate, Soft Blueprint—
创意Dark Luxe, Cosmic DepthPaper CraftBrutalist Mono, Retro Ink
现代/技术Neon Terminal, Cosmic DepthSoft BlueprintBrutalist Mono
温暖Dark LuxePaper Craft, Sage GardenRetro 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 结构

必需功能

  1. 滚动触发展开 — 元素通过 IntersectionObserver 动画进入
  2. 浮动导航 — 带有活动部分跟踪的固定导航
  3. 动画技能条 — 滚动到视图时填充
  4. 滚动进度条 — 顶部细条
  5. 返回顶部按钮 — 滚动后出现
  6. 打印样式表 — @media print,白色背景,无动画,显示 URL
  7. 减少动效 — @media (prefers-reduced-motion: reduce) 禁用动画
  8. 响应式 — 所有尺寸使用 clamp(),适合移动端到桌面端

验证检查清单

交付前,验证:

  • 所有排版使用 clamp(min, preferred, max)
  • 所有间距使用 clamp() 或视口单位
  • 语义化 HTML (<header>, <main>, <section>, <nav>)
  • 包含并有效的打印样式
  • 适配减少动效
  • 导航、按钮、进度条上具有 ARIA 标签
  • 颜色对比度符合 WCAG AA
  • 外部链接包含 target="_blank" rel="noopener"

阶段 4:交付

  1. 清理 — 如果存在,删除 .claude-design/resume-previews/
  2. 打开 — 在浏览器中启动:open [filename].html
  3. 总结:
您的交互式简历已准备就绪!

文件: [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 块。检查动画是否已禁用且背景为白色。

相关技能