# Resume Builder > 通过对话式采访构建精美简历的技能。当用户提到「简历」「resume」「CV」「求职」「找工作」「面试」「制作简历」「生成简历」或者想要创建一个展示个人经历和技能的网页时使用。支持 HTML 简历生成、A4 纸打印布局、PDF 导出。能够引导用户逐步完善简历内容，从个人信息到项目经历全面覆盖。 - Skill: `chasen-liao/resume-builder` (Agent Skill, multi-file: 30 files) - Install (CLI): `npx skillmds@latest add chasen-liao/resume-builder` - Raw SKILL.md: https://api.skillmd.com/api/skills/chasen-liao/resume-builder/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: chasen-liao (https://skillmd.com/u/chasen-liao) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/chasen-liao/resume-builder --- # 简历构建器 (Resume Builder) 通过对话为用户创建**视觉精美、排版专业**的 HTML/PDF 简历，支持视觉 A4 单页和 ATS-safe 两种输出模式。 ## 核心理念 - 输出：独立 HTML 文件，内嵌 CSS，A4 尺寸（210mm × 297mm），浏览器打印 PDF - 设计：大胆有辨识度，拒绝通用 AI 审美（详见 `references/design-guidelines.md`） - 生成前先选择输出模式：视觉 HTML/PDF 或 ATS-safe HTML/PDF；两种模式共享同一事实数据。 ## 先决规则 开始收集、写作或生成前，必须先完整读取并遵循 `references/resume-contract.md` 和 `references/content-writing.md`。这两份共享参考文档优先于本入口中的示例、版式偏好和流程提示；证据不足时保留事实边界，不为填满版面或迎合格式补写内容。 ## 入口与协作 这是创建和更新母版的主入口。若用户提供**已有简历**，先提取为待确认 claim，展示已识别内容、模糊项和疑似过期项；用户确认后只做**增量追问**，优先询问最近变化、缺失证据和低置信度字段。不要将解析文本直接当作最终事实，也不要重新进行完整采访。 若用户没有已有简历，按下面的信息收集流程采访。将用户确认的 claim 保存到项目目录外的私有 `resume-facts.yaml`，其结构使用 `references/resume-facts.example.yaml`；它是后续母版和 JD 定制的事实源。事实确认完成后，才选择输出模式与六个视觉模板。发现某条经历职责化、缺少具体贡献或证据不足时，可建议用户调用 `resume-bullet-writer`；它不是生成母版的必经步骤。 ## 工作流程 ### 第一步：信息收集 仅在从零采访或已有简历存在缺口时逐个板块提问，不要一次抛出所有问题。按 `resume-contract.md` 建立每条 claim 的 `section`、`source`、`confidence`、`evidence`、`metric_status` 记录，并在用户确认后更新私有 `resume-facts.yaml`，再按 `content-writing.md` 写作。 收集顺序：基础信息 → 教育背景 → 实习/工作经历 → 项目经验 → 技能 → 校园经历 → 自我评价 - 优先追问可核验的指标、范围、时间、质量、角色和交付物；没有可信数字时，使用已确认的非数字证据。 - 技能数量、自我评价长度/句数和经历结构服从事实、岗位相关性与版面，不设机械数量或字数门槛。 - 应届生可根据岗位相关性前置项目或校园经历，不把固定排序当成事实规则。 - 待确认字段只能保留在采集记录或分析报告中，不能进入最终简历 HTML/PDF。 ### 第二步：风格确认 先让用户选择视觉 HTML/PDF 或 ATS-safe HTML/PDF 模式，再选择或描述视觉风格。视觉模式读取对应 CSS 和 HTML 参照文件；ATS-safe 模式使用单栏、标准标题和可复制文本结构： | 风格 | CSS | HTML 参照 | |------|-----|----------| | 现代简约 | `css/modern-minimal.md` | `examples/modern-minimal.html` | | 经典商务 | `css/classic-business.md` | `examples/classic-business.html` | | 创意个性 | `css/creative-bold.md` | `examples/creative-bold.html` | | 日式极简 | `css/japanese-minimal.md` | `examples/japanese-minimal.html` | | 科技感 | `css/tech-dark.md` | `examples/tech-dark.html` | | 简约蓝色商务 | `css/minimal-blue-business.md` | `examples/minimal-blue-business.html` | CSS 文件包含 3 套配色变量 + 推荐字体 + 风格 CSS。`css/common.md` 为通用排版（每次必用）。 ### 第三步：生成 HTML 根据第二步选定的模式合并 `css/common.md` 排版 + 对应风格 CSS/布局 + 已通过契约门槛的用户信息，生成独立 HTML。视觉模式使用 `<姓名>_<岗位>_visual.html`；ATS-safe 模式使用 `<姓名>_<岗位>_ats.html`，对应 PDF 使用相同前缀和 `.pdf` 扩展名。 视觉模式： - A4 尺寸、页边距、字号、间距、行高等排版参数参见 `css/common.md`（唯一定义源） - CSS 变量统管颜色，系统字体栈（PingFang SC, Microsoft YaHei） - 交付为单文件时，头像等本地图片使用 `data URL` 内嵌；若保留外部网页字体，必须同时提供系统字体回退，并在验证中说明离线渲染可能不同。 - 技能标签用 `` 排列，badge 样式由风格 CSS 定义（ATS 友好） - 不在简历模板中嵌入导出按钮；PDF 由浏览器打印或本地 Canvas 的“打印为 PDF”操作导出，避免遮挡简历内容 - 使用任一内置风格时，生成的 `` 必须包含对应的 `data-resume-editor-template`（`modern-minimal`、`classic-business`、`creative-bold`、`japanese-minimal`、`minimal-blue-business` 或 `tech-dark`）和 `data-resume-editor-version="1"`。每个需要 Canvas 微调的真实文本必须有稳定、唯一、语义化的 `data-resume-editor-id`；不要依赖运行时补齐。 - `data-resume-editor-id` 只能标在一个具体的文本字段上，例如姓名、职位、日期、板块标题、单条 bullet 或单个技能标签；不要为了“通过协议检查”给整页或整块内容加一个兜底 ID。 - **禁止把编辑 ID 放在** ``、``、`
`、`.page`、`.resume`、`header`、`footer`、`section`、`ul`、`ol`、`figure` 或包含多个板块/多个字段的容器上。带链接的联系方式应把可编辑文本拆成独立字段，不能把整行联系方式作为一个可编辑容器。 - 上述标记供 `npx -p @chasen-liao/resume-skills@latest resume-skills editor ` 的本地 Canvas 微调器识别；Canvas 可编辑已有字段的纯文本并保存受限排版覆盖，不允许插入 HTML 或新增字段。文字事实变更后必须重新确认事实并验证 PDF；不要将标记用于头像、布局容器、任意 HTML 或未经确认的字段。 ATS-safe 模式： - 使用单栏、标准板块标题、普通可复制文本和稳定的正文阅读顺序；重要信息不依赖图片、文本框、复杂嵌套表格、页眉页脚或装饰字体。 - 技能以可复制文本列表表达；不因 ATS-safe 模式改变 claim 内容、证据状态或删除待确认标记之外的事实。 - 同样只生成 HTML 与浏览器打印 PDF；仓库当前没有 DOCX 生成能力，不承诺 DOCX 产物。 ### 第四步：按模式验证（强制执行，不可跳过） 生成最终视觉 HTML 后，先做 Canvas 字段验收，再渲染 PDF： - 先运行可执行校验（失败即停止，严禁跳过）：`npx -p @chasen-liao/resume-skills@latest resume-skills validate "<最终_visual.html路径>"`，重复直到输出“校验通过”。 - 再按下列规则手工复核：在最终 HTML（完成事实替换和定制后，不是只检查参考模板）统计 `data-resume-editor-id`，记录字段总数、重复 ID、容器误标 ID，以及 `profile-*` 和 `*-bullet-*` 字段是否存在。 - 字段总数必须大于 0，ID 必须唯一且符合小写语义化命名；`main/page/resume/section` 等整页或板块容器不得带 ID。 - 每个 ID 节点的文本必须对应一个可独立编辑的字段；如果一个节点同时包含多个板块、列表或大量链接文本，必须拆分标记。 - 任一检查失败都不得启动 Canvas、渲染 PDF 或交付；修正 HTML 或重新生成后从头复验。禁止用一个根容器 ID 代替字段标记。 视觉 HTML/PDF：导出 PDF 后同时检查结构、PDF 页数和可提取文本、页面密度和可打印安全区： ```bash powershell -NoProfile -ExecutionPolicy Bypass -File skills/resume-builder/scripts/render_resume.ps1 -HTML "<生成的_visual.html路径>" -OutputPdf "<生成的_visual.pdf路径>" ``` `--check-layout` 的验收规则： - `PDF page count` 必须是 `1 page`；超过 1 页直接失败，不能用裁切或隐藏溢出伪装成单页。 - `page fill` 以 PDF 可提取文本的纵向范围估算页面占用率，目标至少 `78%`；低于目标是警告，必须继续调整到接近一页，但不能为填白编造事实。 - `vertical balance` 检查可打印区域上下留白差；出现警告时优先均匀调整板块间距、条目间距和容器内边距，避免内容挤在顶部或底部。 - `bottom safety` 不得失败；内容越过可打印底部安全区时，必须回退间距或字号调整。 版面调整顺序：先使用已有且已确认的板块和内容；页面偏空时均匀增加板块/条目间距、行高或容器内边距，页面溢出时反向压缩；仍溢出再按“页边距不小于 8mm → 间距 → 行高不低于 1.25 → 正文不小于 9.5px → 精简低相关内容 → 在适合时切换双栏”的顺序处理。上下间距尽量相近，任何一次调整后都重新导出 PDF 并运行同一命令。不得新增未确认经历、指标、技能或占位文本，也不以难以阅读的小字号硬塞一页。 渲染脚本会执行浏览器溢出和 PDF 布局验证，并生成同名前缀的 `*.resume-manifest.json`，其中包含 HTML/PDF SHA-256、renderer 版本和验证结果。`degraded`、`fail` 或 hash 不一致都不可交付。完成自动检查后，再人工检查截图中的可见裁切、字体回退、链接和打印背景；自动检查不能保证这些视觉细节。视觉模式以 A4 单页为目标，所有警告都要记录处理结果。 ATS-safe HTML/PDF：检查 DOM 是否单栏、标题和时间/组织/职位关系是否清晰、正文复制后顺序是否正确，以及 PDF 文本是否可提取；再检查无图片文字、复杂嵌套表格、关键页眉页脚信息和不可复制装饰字体。按目标平台要求检查 HTML/PDF 格式，不宣称 ATS 必然通过。 ### 第五步：交付 视觉模式完成 A4/PDF 验证后，先询问用户是否需要打开本地 Canvas 预览。Canvas 是视觉版的可选微调工具，不是 Skills、HTML 或 PDF 交付的前置条件：用户选择需要时才执行下面的命令；用户暂时不需要时直接交付已验证的 HTML/PDF，并说明之后可按需启用。 ```bash npx -p @chasen-liao/resume-skills@latest resume-skills editor "<生成的_visual.html路径>" ``` 高级 CLI 参数说明（适用于 Agent 自动化或无 GUI 容器环境）： - `--json`：以 NDJSON 逐行输出事件（`server_started` / `error` / `update_available` / `validation_passed`）；协议/参数/端口失败均输出 `event: "error"`。服务继续运行，脚本逐行 `JSON.parse`。 - `--no-open`：禁用自动打开系统浏览器（适合控制台或集成环境）。 - `--port `：指定监听端口。 - **Live Preview**：编辑器建立连接后支持 SSE 热刷新。当 Agent 重新写入或修改该 HTML 时，页面将自动重载展示最新效果。 用户选择 Canvas 后，命令会在本机启动服务并打开浏览器。告知用户原始 HTML 和 PDF 的位置；Canvas 保存时会直接覆盖该 HTML，并将关联 PDF manifest 标为失效。保存后必须重新运行渲染脚本，只有新 manifest 的 hash 和验证结果有效才可交付。Canvas 只允许编辑已有字段的纯文本和受限排版，不能插入 HTML、做 JD 匹配或调整结构。如用户选择 Canvas 但当前环境无法执行 `npx`，明确报告未启动，并提供带实际 HTML 路径的完整命令，不得声称已启动。 ATS-safe 模式不使用 Canvas（其单栏 HTML 不属于 Canvas 支持的视觉模板）；告知文件位置与浏览器打印 PDF 方法。两种模式都可在后续使用 `jd-tailorer` 针对 JD 定制。 ## 参考文档索引 `references/` 目录下按需读取： - `design-guidelines.md` — 设计美学、字体排版、单页参数细节 - `resume-contract.md` — 事实来源、证据、置信度、指标状态和输出门槛 - `resume-facts.example.yaml` — 私有 `resume-facts.yaml` 的最小结构 - `color-palettes.md` — 六大风格-配色索引 - `content-writing.md` — 证据优先写作、ATS 两种输出模式、自检清单 - `css/README.md` — CSS 使用方式与配色选择策略 - `css/common.md` — 通用紧凑排版 CSS（每次必用） - `css/