make-resume

/make-resume：制作与复刻可编辑简历

/make-resume 是唯一的简历文件制作入口。默认使用仓库中的 ASu 单栏高密度技术简历模板作为只读母版；用户明确指定其他模板、本地 HTML、模板名称或参考截图时，优先按指定模板生成。无论使用哪种模板，交付物都必须是真正可编辑的 HTML，并支持打印或导出 PDF。

路由边界

• 只改写经历、项目或 HR 话术：使用 /great-resume；
• 制作、修改、复刻任何 HTML/PDF 简历，或选择简历模板：使用 /make-resume；
• “我要阿酥同款简历”等同于选择默认 ASu 模板，仍使用 /make-resume，不再路由到另一个简历 skill。

模板与资源

默认模板壳是 assets/asu-resume/template.html。

用户可以通过以下方式指定模板，优先级高于默认模板：

1. 指定仓库模板名或路径；
2. 提供本地 HTML/Word/PDF/简历图片作为参考；
3. 指定 assets/templates-html/ 下的模板壳文件。

仓库中的 assets/asu-resume/template.html 和 assets/templates-html/ 为模板壳文件，共享外框位于 assets/frame/。Agent 只读取内容壳，在用户目录创建并修改副本。壳文件只有设计稿，交付前必须用 scripts/ 下的脚本内联共享的 base.css、toolbar.css、toolbar.html 和 editor.js，生成自包含 HTML；不能把壳文件直接交给用户。参考截图只用于分析版式，不能整页嵌入最终简历。

如果 skill 被单独复制到其他目录，先从当前 skill 目录向上定位 assets/，只有在该目录包含完整模板资源时才使用它。完整资源至少包括 resume-data-template.json、template-overview.jpg、fictional-resume-photo.png、frame/ 下的 base.css、toolbar.css、toolbar.html、editor.js，以及全部 18 个模板壳文件。找不到完整资源时必须明确说明，使用简洁 A4 后备模板，并说明不保证 18 套模板、预览图、示例照片或原模板复刻精度。

工作流程

1. 盘点用户消息、附件和项目文件中的姓名、联系方式、教育、实习/工作、项目、技能、目标岗位、公开链接、页数和照片需求。用户提供主张—证据账本时，按 账本状态规则 读取事实。
2. 如果用户提供 PDF、已有简历、截图、图片或文档，先提取文字并分析栏位、间距、字体层级、颜色、照片位置和分页，再选择模板。未指定模板时使用默认 ASu 模板；指定模板时不擅自替换。
3. 缺少关键字段时只补问真正影响交付的内容。姓名、学校、公司、职位、时间和成果指标不得捏造；无法补齐时使用 待补充 或 待确认 占位。
4. 按“模板选择矩阵”决定页数和内容顺序。内容能在正常字号下形成完整单页时优先单页；需要双页时先填实第一页，再让第二页承接补充内容，不为了模板结构过早分页。
5. 生成用户专属可编辑 HTML。先根据模板壳生成用户内容壳，然后在仓库根目录执行：默认 ASu 模板用 node scripts/build-asu-resume.mjs <用户内容壳> <用户输出HTML>，其余模板用 node scripts/inline-template.mjs <用户内容壳> <用户输出HTML>。脚本完成公共工具栏/样式/代码内联。引用的图片、icons/ 和 logos/ 按输出 HTML 的相对路径一起交付。
6. 公司或平台名称能够确认时匹配品牌 Logo。优先复用共享 assets/logos/ 中的实际 SVG；缺少对应资源时使用 @lobehub/icons 或 @lobehub/icons-static-svg 的官方 SVG，并将用户专属 Logo 放在用户副本旁的 logos/ 目录。无法确认品牌或没有可用资源时使用纯文字公司条，不用相似 Logo 代替。
7. 将 print-preview 作为交付前强制 QA：检查 A4 纸张、分页、单双栏、照片比例、长文本溢出、中文字体、打印边距、工具栏隐藏、链接可识别和公司 Logo 比例，再按 A4 页面平衡与视觉密度 QA 测量每页内容占用并保存整页截图。发现问题先修复 HTML/CSS。
8. 按 PDF 导出验收标准 生成或指导生成 PDF，不用截图替代可编辑源文件。

正式成稿只使用当前岗位适用且状态为“已确认”的主张；“待确认”只可留在内部草稿中，导出最终 PDF 前必须确认或删除。“已过期”和“不采用”的主张不得进入对外材料。

输入清单

• 基础信息：姓名、电话、邮箱、城市/籍贯、求职方向、个人主页/GitHub/作品集（可选）；
• 教育背景：学校、学历、专业、起止时间、GPA/排名、主修课程、奖项；
• 实习/工作：公司或团队、岗位、起止时间、业务背景、个人职责、技术栈、结果证据；
• 项目经历：项目名称、岗位相关性、个人边界、技术栈、核心动作、结果证据、公开链接或截图；
• 技能：语言、框架、数据库、中间件、工具链、英语/证书；
• 投递目标：岗位名称、JD、校招/社招、页数要求、风格偏好、是否需要照片；
• 模板偏好：默认 ASu 模板，或用户指定的模板文件、模板名称、参考图片；
• 输出要求：HTML 保存位置、是否同时导出 PDF、文件命名和隐私处理。

缺失字段补问规则

• 最多一次补问 3 个最关键问题，优先问会改变模板和内容结构的问题：目标岗位、页数、是否已有完整简历/附件；
• 用户要求先生成初稿时，不等待所有字段齐全，用 待补充 标记姓名、时间、公司和成果数据等缺口；
• 教育、工作、项目的正式名称和时间不得代填；成果指标没有证据时写可核验的定性结果或 待确认；
• 发现真实隐私信息时，只写入用户要求的简历文件，不写入 skill 模板、示例、README 或公开说明；
• 同一字段在多个来源冲突时，列出冲突项并请用户确认，不自行选择更“好看”的版本。

模板选择矩阵

用户明确指定模板时，始终以指定模板为准；未指定时默认使用 ASu 单栏高密度技术简历模板。

场景	推荐模板结构	适用内容密度	风格
用户要求 ASu 同款、AI/Agent/LLM 技术岗	ASu A4 单栏高密度，项目与技术证据优先	高：多段实习/项目 + 技术栈	专业、证据导向
后端开发 / Python / Java	A4 单页双栏或紧凑单栏	中高：2—3 段项目/实习 + 技能栈	稳重、工程化
数据分析 / 算法 / AI 应用	A4 单页或双页，项目和实验结果优先	高：指标、模型、数据集、可视化较多	专业、证据导向
产品 / 运营 / 商务	A4 单页，经历成果和业务指标优先	中：实习/活动/项目较均衡	简洁、结果导向
设计 / 新媒体 / 作品集岗位	A4 单页视觉型或带作品链接结构	中低：强调作品入口和视觉层级	有辨识度但不过度装饰
校招无实习或经历较少	A4 单页双栏，教育、技能、项目补足版面	低到中：1—2 个项目	稳妥、留白合理
社招或经历较多	A4 双页，工作经历按时间倒序	高：多段工作/项目/成果	稳重、信息密度高

默认决策：

• 默认 ASu 模板使用单栏、高密度、蓝色分区标题、浅灰经历条和右上角照片位；
• 内容超过单页且压缩会损害可读性时，改为双页而不是把字号缩到不可读；
• 单页优先形成“身份定位—最强证据—核心经历—技能”的完整闭环；
• 用户明确要“稳妥版”时优先保守措辞和证据完整性；明确要“进取版”时可强化定位，但必须标注待补证据。

默认排版

• 默认 A4，左右边距以所选模板为基准并保持稳定分页；
• 默认白底并使用一个主强调色，避免过度装饰；
• 页面内容必须可选中、可修改、可复制；
• 用户没有提供真实照片时可以使用虚构示例照片，并提醒替换；
• 不把用户真实个人信息写入插件的模板、示例或 README。

Print-preview QA

交付 HTML 前必须检查打印预览或等价的 print media 渲染结果：

• A4 页面尺寸、页边距和分页稳定，没有多余空白页；
• 页面占用符合 页面平衡规则：单页不过空，多页的非末页先填实，末页没有可通过重排消除的大面积空白；
• 单栏/双栏结构符合所选模板，打印预览中不会被移动端 CSS 改成错误布局；
• 长姓名、邮箱、链接、项目标题和技能标签不溢出、不重叠、不遮挡后续内容；
• 照片比例正常，未被拉伸、压扁或裁切到关键区域；
• 工具栏、编辑按钮、调试提示在打印时隐藏；
• 中文字体可读，字号不低于正常投递可接受范围；
• 背景色、分割线和标签在开启“背景图形”后表现正常，关闭背景图形时仍可读。

如果无法自动打开浏览器或生成预览图，必须在交付说明中写明未完成自动 QA，并给出人工检查步骤。

PDF 导出验收标准

本机装有 Edge/Chrome 时，可用零依赖脚本 scripts/export-resume-pdf.mjs 自动导出（npm run export:pdf -- <html路径> --out <pdf>，preferCSSPageSize 让 PDF 纸张跟随模板 @page）；浏览器打印另存为 PDF 作为兜底。

• 文件页数符合预期：单页模板导出 1 页，双页模板导出 2 页，除非用户明确允许扩页；
• PDF 中没有工具栏、编辑虚线、浏览器页眉页脚、URL、日期或多余空白页；
• 页面为 A4，缩放建议 100%，页边距使用默认/无边距时均不破坏内容；
• 双栏、表格、标签、项目符号和分割线位置正确；
• 文本可选中、可复制，不能把整页截图当成 PDF；
• 公开链接在纸面上仍可识别目的地，不能只显示“网站”“PAPER”“CODE”等失去上下文的标签；
• 长链接去掉无关追踪参数并允许自然换行，导出后从 PDF 文本中抽查关键域名或 DOI；
• 如使用照片，照片清晰且比例正确；如使用占位照片，交付说明提醒替换；
• 推荐浏览器设置：Chrome/Edge、另存为 PDF、A4、背景图形开启、页眉页脚关闭、缩放 100%。

LaTeX 输出（可选）

面向习惯 LaTeX 或需要在 Overleaf 继续维护简历的用户，.tex 是可选附加格式，不替代 HTML 交付。只有用户明确要求 LaTeX、.tex 或 Overleaf 版本时才生成；默认交付流程不变。

• 模板指定方式与 HTML 一致。 未指定时使用默认的 ASu 单栏版式；用户指定其他 .tex 母版时，把母版路径作为第三个参数传给脚本。目前 assets/latex-resume/ 下提供三套版式：
  • template.tex：ASu 单栏高密度，蓝色分区标题，与默认 HTML 模板观感一致，未指定时使用；
  • compact.tex：紧凑单栏，收紧页边距与行距、章节标题用色块，适合经历较多需压进单页的候选人；
  • academic.tex：学术风，无彩色、小型大写标题、行距宽松，黑白打印友好，适合科研与教职投递。 三套都只使用 TeX Live 基础发行版自带宏包。assets/templates-html/ 下的 18 套 HTML 模板中，带侧边栏、时间线、圆角卡片的版式依赖 CSS Grid 与圆角阴影，在不引入额外宏包的前提下无法等价复刻，因此未逐一对应；用户指定这些模板要求 .tex 时，说明这一边界并推荐上述最接近的一套。
• 信息等价，版式不等价。 .tex 保证章节顺序和内容与 HTML 一致，不承诺像素级复刻 ASu 样式。
• 证件照与校标。 数据中的 profile.photo 指定图片文件名时，头部自动分为左文字右图片两栏；为空时退化为纯文字单栏。图片文件名只允许字母、数字、点、下划线和连字符（\includegraphics 的文件名参数不做转义），交付时必须把图片文件和 .tex 一起给用户。母版对图片缺失有容错：找不到文件时画占位框并提示，不会中断编译。
• 仓库不编译 LaTeX，也不要求用户安装 TeX。 产物是纯文本源文件，编译交给 Overleaf 或用户已有的本地环境。

生成方式：先把已确认的简历事实写成结构化 JSON（字段见 ../../assets/resume-data-template.json，缺省字段对应的整节不输出），再在仓库根目录执行 node scripts/build-latex-resume.mjs <简历数据JSON> <用户输出TEX> [母版TEX]。第三个参数省略时使用默认 ASu 母版，这与 inline-template.mjs 由调用方指定壳文件的方式一致。任何包含全部 @ 标记的 .tex 都可以作为母版：版式差异集中在母版导言区，脚本的转义与章节生成逻辑与版式无关，可被各版式复用。

默认母版是 ../../assets/latex-resume/template.tex，脚本统一处理 LaTeX 转义。新增版式只需在 assets/latex-resume/ 下添加一个包含全部 @ 标记、并定义 \asuphotowidth、\asuheadtextwidth、\asuphoto、\asuname、\asumeta、\asuentry 的 .tex，不需要改动脚本；测试会自动遍历该目录校验新版式。不要绕过脚本手写 .tex：简历正文里的 C++、30%、snake_case、A&B 等内容未经转义会直接导致编译失败。

交付 .tex 时必须附上 Overleaf 使用步骤（三步）：① New Project → Blank Project，填写 Project name 后 Create；② 上传 .tex，使用证件照或校标时把图片一并上传到同一项目；③ File → Settings 中把 Main document 选为该文件、Compiler 选择 XeLaTeX（中文必需，pdfLaTeX 会失败），然后 Recompile。母版只使用 TeX Live 基础发行版自带宏包，且不指定中文字体（回落到 Overleaf 内置的 Fandol），以保证跨环境编译可复现。

交付内容

默认交付可编辑 .html 文件、使用的模板说明、资源或 fallback 状态、print-preview QA 结果、各页内容占用比例、浏览器编辑与保存方法和 PDF 导出方法。若用户同时需要经历改写，先调用 /great-resume 完成文字，再将确认后的内容放入 /make-resume 生成的用户副本；不得修改默认 ASu 模板或用户指定的只读模板源文件。