generate

用途

generate 是 resume-builder 技能中的生成命令，用于运行确定性的生成流水线，从 resume.yaml 生成简历输出文件。该命令不进行 LLM 内容生成，只做纯解析与渲染。

主要能力

• 从 resume.yaml 生成 PDF、DOCX、HTML 和 Markdown 四种格式。
• HTML（index.html）为作品集级页面，内置深色/浅色主题切换（localStorage）、卡片悬停聚光、滚动揭示动画、英雄区视差、环境背景光晕、渐变文字微光、卡片式布局与悬停抬升、时间线可视化、交互式技能标签、完整移动端响应式以及 prefers-reduced-motion 支持，无需配置。
• PDF（resume.pdf）为简洁专业文档，可通过 templates/pdf_styles.yaml 自定义。
• DOCX（resume.docx）为 Word 文档，通过 templates/docx_styles.yaml 使用与 PDF 相同的样式模式。
• Markdown（resume.md）为 GitHub 风格 Markdown，无样式。

使用方式

生成前需确认项目中存在 resume.yaml。

基本命令：

resume-builder generate --format pdf,docx,html,md --output-dir .

生成后报告生成的文件及其大小，并运行以下命令确认来源完整性：

resume-builder verify

选项：

• 生成所有格式：resume-builder generate
• 指定格式：resume-builder generate --format pdf
• 自定义输出目录：resume-builder generate --output-dir ./output
• 自定义输出基名：resume-builder generate --output-name wilson_resume

输出命名：pdf、docx 和 md 输出共享同一基名，默认是 resume（resume.pdf、resume.docx、resume.md）。若要在每次运行时个性化基名，可在 resume.yaml 中添加顶层 output_name 字段（例如 output_name: wilson_resume），技能会自动识别，无需标志。--output-name 标志可覆盖单次运行的 YAML 值。HTML 始终写为 index.html，不受 output_name 影响，以便直接由 GitHub Pages 提供服务。

模板自定义：用户可在 resume.yaml 同级放置 templates/ 目录来自定义生成输出的外观：

• templates/pdf_styles.yaml — 覆盖 PDF 颜色、字体、边距和样式属性
• templates/docx_styles.yaml — 覆盖 DOCX 颜色、字体、边距和样式属性
• templates/resume.html.j2 — 替换整个 HTML 模板
• templates/style.css — 覆盖 HTML 输出的 CSS 自定义属性

开始使用：resume-builder template-export

使用模板生成：resume-builder generate --template-dir templates

或直接在 resume.yaml 同级放置 templates/ 目录，会被自动发现。

适用场景

适用于需要将结构化简历数据批量导出为多种格式，并希望获得可直接部署的 HTML 页面的场景。

限制

该命令完全确定性，相同输入始终产生相同输出，渲染流水线不涉及 LLM。如果 resume YAML 已被 /ingest 或 /tailor 修改，需重新生成以更新所有输出。输出文件名为 <output_name>.md、<output_name>.pdf、<output_name>.docx（默认基名 resume），外加始终命名为 index.html 的 HTML 文件。