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. 盘点用户消息、附件和项目文件中的姓名、联系方式、教育、实习/工作、项目、技能、目标岗位、公开链接、页数和照片需求。用户提供主张—证据账本时，按 [账本状态规则](../great-resume/references/claim-evidence-ledger.md) 读取事实。 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](references/page-balance-qa.md) 测量每页内容占用并保存整页截图。发现问题先修复 HTML/CSS。 8. 按 [PDF 导出验收标准](#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 页面尺寸、页边距和分页稳定，没有多余空白页； - 页面占用符合 [页面平衡规则](references/page-balance-qa.md)：单页不过空，多页的非末页先填实，末页没有可通过重排消除的大面积空白； - 单栏/双栏结构符合所选模板，打印预览中不会被移动端 CSS 改成错误布局； - 长姓名、邮箱、链接、项目标题和技能标签不溢出、不重叠、不遮挡后续内容； - 照片比例正常，未被拉伸、压扁或裁切到关键区域； - 工具栏、编辑按钮、调试提示在打印时隐藏； - 中文字体可读，字号不低于正常投递可接受范围； - 背景色、分割线和标签在开启“背景图形”后表现正常，关闭背景图形时仍可读。 如果无法自动打开浏览器或生成预览图，必须在交付说明中写明未完成自动 QA，并给出人工检查步骤。 ## PDF 导出验收标准 本机装有 Edge/Chrome 时，可用零依赖脚本 [scripts/export-resume-pdf.mjs](../../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`](../../assets/resume-data-template.json)，缺省字段对应的整节不输出），再在仓库根目录执行 `node scripts/build-latex-resume.mjs <简历数据JSON> <用户输出TEX> [母版TEX]`。第三个参数省略时使用默认 ASu 母版，这与 `inline-template.mjs` 由调用方指定壳文件的方式一致。任何包含全部 `@` 标记的 `.tex` 都可以作为母版：版式差异集中在母版导言区，脚本的转义与章节生成逻辑与版式无关，可被各版式复用。 默认母版是 [`../../assets/latex-resume/template.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 模板或用户指定的只读模板源文件。