| name | html-resume-builder |
| description | 将已经确认的简历内容制作成一页 A4 HTML/PDF，并完成模板复制、头像处理、导出和视觉 QA。用于纯排版、HTML/PDF 成品、打印优化和交付检查；不用于 JD 分析、事实判断、ATS 策略或简历措辞改写。 |
HTML Resume Builder
职责边界
只渲染已经确认的 resume version。不得改变候选人事实、补写指标，或为了填满页面新增未经确认的内容。
- 内容需要分析或改写时，先使用
jd-analysis / resume-tailor。
- 用户只要求排版、导出或视觉修正时，直接使用本 skill；不要重复运行 JD 分析或重写内容。
- 内容不完整时，明确列出缺失项并暂停正式导出，不要用模板示例补位。
支持范围
正式模板只包含 assets/templates/basic-a4/。它是一页 A4、单栏、ATS 友好的稳定基线。不要引用或承诺其他模板；新增模板应作为独立任务完成设计、验证和用户确认后再纳入。
模板和脚本改编自 KevinYoung-Kw/vibe-resume-skill，遵循 CC BY-NC 4.0。保留归因；未经授权不得把借用资源用于商业分发。
工作流
-
确认输入已经稳定：正文、联系方式、日期、链接和头像均来自用户确认的信息。
-
创建独立工作目录：
python skills/html-resume-builder/scripts/create_workspace.py --output <workspace>
-
替换 resume.html 中全部示例内容和占位资源。保持经历类别真实，不得把实习、项目或正式工作互相挪用。
-
按 references/template-contract.md 调整 A4 排版。优先调整字号、行高和间距，不得用弱内容填充页面。
-
运行严格导出：
python skills/html-resume-builder/scripts/export_and_qa.py <workspace>/resume.html --pdf <workspace>/resume.pdf --strict-final
-
读取 JSON 结果并检查生成的整页截图。只有脚本退出成功、ok 为 true 且人工视觉检查通过，才可声明完成。
交付门禁
- PDF 必须是一页 A4 竖版，文字可提取，字体列表可读取。
- 不得残留示例姓名、示例联系方式或
example.com。
- 不得出现重叠、裁切、头像变形或大面积空洞。
- 正文底部留白不得超过页面高度的 15%。
- 项目特有的敏感词通过
--forbid-term <term> 显式传入，不设置会误伤正常简历内容的通用禁词。
- 严格检查缺少 Chrome 或所需 PDF 检查工具时必须视为未完成，不得绕过后声称交付成功。
最终检查时读取 references/qa-checklist.md。
