| name | resume |
| description | 岗位针对性简历生成器。当用户提供 JD（岗位描述）、面经或岗位分析，或提出"帮我生成简历"、"针对这个岗位"等请求时触发。自动检查用户数据完整性，分析岗位需求，从经历库中智能筛选内容，生成单页 LaTeX 简历 PDF，自动调优至恰好一页。 |
| license | Apache-2.0 |
Resume Generation Skill
角色分工：本文件是执行流程（按步骤做）；CLAUDE.md 是规则百科（详细约束），两者互补。遇到细节问题以 CLAUDE.md 为准。
Step 0：前置检查
- 确定活跃人员 →
tools/person_manager.get_active_person_id()（None = legacy 模式）
- 读取对应
profile.md（legacy: data/profile.md）
- 读取对应
experiences/ 目录、项目经历、校园经历作为增强资料（legacy: data/experiences/）
阻断条件（任一触发则停止，提示用户）：
profile.md 含 [YOUR_XXX] 占位符- 基本信息缺少中文姓名、邮箱、电话
- 教育背景没有至少一条学校信息
- 技术技能和软件工具均为空
experiences/、项目经历、校园经历为空时不阻断，但应提示用户补充可显著提升匹配质量。
Step 1：岗位分析
从 JD / 面经中提取：
| 维度 | 提取内容 |
|---|
| 公司 + 岗位 | 如「美团 · 商业分析师」 |
| 岗位类型 | 产品 / 运营 / 技术 / 金融 / 咨询 / 研究 / 其他 |
| 硬技能关键词 | 技术栈、工具、编程语言 |
| 职能关键词 | 数据分析、行业研究、策略规划、商业化… |
| 行业关键词 | 互联网、金融、AI、医疗… |
| 软技能 | 沟通、跨部门协作、自驱… |
输出：一段简短的岗位画像（后续所有选择都以此为锚点）。
Step 2：内容匹配与选取
2.1 读取所有经历文件
读取 experiences/*.md（跳过 _template.md、README.md、空文件），同时读取 profile.md 中的项目经历和校园经历。
同时检查 work_materials/{公司名}/ 是否有非空文件 → 有则优先用作内容来源。
2.2 分类（严格执行）
| 分类 | 判定条件 | 放入 section |
|---|
| 实习/工作 | 文件名不含 研究_，且标签不同时包含 研究+学术 | \section{实习经历} |
| 研究/项目 | 文件名含 研究_，或标签同时含 研究+学术 | \section{研究经历} 或 \section{项目经历} |
| 校园经历 | profile.md 中的校园经历，且与 JD 相关或能证明组织/领导/活动运营/竞赛成果 | \section{校园经历} / \section{Campus Experience} |
- 大学/学院课题研究 ≠ 实习，禁止放入「实习经历」
2.3 选取
| 类型 | 数量 | 说明 |
|---|
| 实习经历 | 2-4 段 | 核心内容 |
| 研究/项目 | 0-2 段 | JD 要求研究能力时加入 |
| 校园经历 | 0-2 段 | 仅在 JD 相关、经历不足或能证明组织/领导/活动运营/竞赛成果时加入 |
| 合计 | ≤ 5 段 | 目标占满整页 |
- 按 JD 关键词 vs 经历标签的匹配度排序选取
- 严格时间倒序排列（最新在前）
- 每段经历只能出现在一个 section（去重）
2.4 改写 Bullet
数量：实习/工作经历每段 2-3 条，最多 4 条；项目/研究/校园经历 1-2 条
改写规则（逐条必须遵守）：
| # | 规则 | 示例 |
|---|
| 1 | 结尾不加句号 | ✗ …提供数据支撑。 → ✓ …提供数据支撑 |
| 2 | 保留量化数据，不捏造 | ✓ 产出50页报告 ✗ 产出大量报告 |
| 3 | 动词名词向 JD 靠拢（不改变事实） | JD 要"商业分析" → bullet 用"商业分析"而非"行业调研" |
| 4 | 结果导向，不是"负责了什么" | ✗ 负责数据分析 → ✓ 分析…数据，发现…，推动… |
| 5 | 城市从经历文件读取，不猜测 | — |
| 6 | 禁止外部过时数据（营收/CAGR 等） | ✗ 营收294亿元 → ✓ 删除 |
| 7 | 禁止领域专有术语 | ✗ "三大鸿沟" "算力券" → ✓ 通用描述 |
| 8 | 研究 bullet 面向岗位改写 | ✗ 堆砌 三重交互/DID/聚类稳健标准误 → ✓ 聚焦数据规模、工具、产出 |
| 9 | 中文引号用 "…" | ✗ „..." ✗ "..." |
| 10 | 不添加用户未提及的技能/成果 | — |
2.5 选取获奖
从 profile.md 的获奖部分中选取，最多 3 条：
优先级（从高到低）：
- 与 JD 直接相关（如数学建模 → 数据分析岗）
- 国际级 / 国家级高含金量奖项
- 奖学金只保留最高等级 1 条
必须排除：
- 同类奖学金的低等级（有特等就不要二等）
- 低含金量（三等奖、公益类）
- 与 JD 完全无关的奖项
Step 3：生成 LaTeX
3.1 准备输出目录
OUTPUT_DIR="$(pwd)/output/{公司}_{岗位}_{YYYYMMDD}"
mkdir -p "$OUTPUT_DIR"
TEMPLATE_DIR="$(pwd)/latex_src/resume"
for f in "$TEMPLATE_DIR"/*; do
[ "$(basename "$f")" = "fonts" ] && continue
cp -r "$f" "$OUTPUT_DIR/"
done
ln -sf "$TEMPLATE_DIR/fonts" "$OUTPUT_DIR/fonts"
3.2 写入 .tex
修改 $OUTPUT_DIR/resume-zh_CN.tex 或 $OUTPUT_DIR/resume-en.tex（按 language=zh|en），各 section 内容来源：
| Section | 来源 | 注意 |
|---|
| 头部（姓名/联系方式） | profile.md | — |
| 教育背景 | profile.md | 按岗位选 4-5 门课程 |
| 实习经历 | Step 2 选定的实习经历 | 时间倒序，按分类放 |
| 研究/项目经历 | Step 2 选定的研究经历 | 可选，0-2 段 |
| 校园经历 / Campus Experience | Step 2 选定的校园经历 | 可选，0-2 段，不相关时不展示 |
| 获奖情况 | Step 2.5 选定 | ≤ 3 条 |
| 技能 | profile.md | 按岗位调整顺序 |
3.3 输出前强制验证 ✅
写入 .tex 前必须逐项检查，全部通过才能写入：
任一项 ✗ → 修正后重新检查，直到全部 ✓
Step 4：编译
export PATH="$HOME/Library/TinyTeX/bin/universal-darwin:$PATH"
cd "$OUTPUT_DIR"
xelatex -interaction=nonstopmode resume-zh_CN.tex > /tmp/xelatex_out.txt 2>&1
xelatex -interaction=nonstopmode resume-en.tex > /tmp/xelatex_out.txt 2>&1
echo "Exit: $?"
sleep 2
mdls -name kMDItemNumberOfPages resume-zh_CN.pdf
mdls -name kMDItemNumberOfPages resume-en.pdf
- 编译失败 → 检查
.log，常见：&→\&，%→\%，_→\_
- 页数 = 1 → 进入 Step 5 填充率检查
- 页数 > 1 → 进入 Step 5 单页调优
Step 5：单页调优 & 填充率检查
5.1 超页时：按序精简（每步后重新编译确认页数）
注意：代码 _tune_overflow() 自动执行的顺序是：排版压缩（vspace → margins → list spacing）→ 内容删减（research → project → bullets）→ 极端压缩（font size → section spacing）。手动操作时建议先尝试内容精简。
第一轮：内容精简（手动优先，效果最大）
| 序号 | 操作 | 说明 |
|---|
| 1 | 修复悬挂行 | bullet 末尾 1-3 字独占一行 → 删/改尾部冗余 |
| 2 | 精简获奖至 ≤ 3 条 | 删低含金量 |
| 3 | 注释研究/项目经历整块 | 效果 ~60mm |
| 4 | 注释最不相关的一段实习 | 效果 ~60mm |
| 5 | 减少 bullet：3 条 → 2 条 | — |
第二轮：排版压缩（内容精简后仍溢出）
| 序号 | 操作 | 修改文件 |
|---|
| 6 | \vspace{-6pt}→-8pt，-2pt→-4pt | .tex |
| 7 | top/bottom 0.5in→0.4in | resume.cls |
| 8 | itemsep/topsep 0.1em→0.05em | resume.cls |
| 9 | \titlespacing *1.5/*1.3→*1.0/*0.8 | resume.cls |
| 10 | \LoadClass[10pt]→[9.5pt] | resume.cls |
红线：字号 ≥ 9pt，页边距 ≥ 0.35in
每步后必须：编译 → mdls -name kMDItemNumberOfPages → 1 页则立即停止
5.2 填充率检查
python3 tools/page_fill_check.py "$OUTPUT_DIR"
| 填充率 | 状态 | 处理 |
|---|
| 95% ~ 100% | 理想 | 无需调整 |
| < 95% | 偏空 | 增加经历/bullet/间距（详见 CLAUDE.md） |
| > 100% | 溢出 | 回到 5.1 继续精简 |
Step 6：输出汇报
6.1 输出到用户
✅ 简历已生成
- 岗位：{公司} · {岗位名}
- 路径：output/{...}/resume-zh_CN.pdf 或 output/{...}/resume-en.pdf
- 页数：1 页 | 填充率：XX%
📋 选入经历：
1. {公司A} — 匹配关键词：xxx, xxx
2. {公司B} — 匹配关键词：xxx, xxx
...
🔧 调优记录：（如有）
- ...
6.2 写入 generation_log.md
保存到 $OUTPUT_DIR/generation_log.md，内容：
- 目标岗位 + JD 关键词
- 选入经历 + 选择理由
- Bullet 改写说明
- 调优记录
