resume-onepager-skilllisted
Install: claude install-skill Zaosusu/resume-onepager-skill
# 简历skill
把「照片 + 人物信息」渲染成一页 A4 简历。风格固定,内容可换,**同一套模板服务任何人**。
产出的 PDF **带真实文字层**——可搜索、可复制、HR 系统能解析。这是本 skill 存在的主要原因:让 AI 直接"画"一张简历图,可提取文字为 0,改一个字要做逐像素字形替换。
## 何时使用
用户给出人像照片 + 任何形式的个人信息,希望产出简历 / 个人介绍页时。也包括「改简历里某处内容」——改 YAML 重跑即可,秒级出片。
## 前置条件
```bash
pip install -r requirements.txt # playwright jinja2 pyyaml pymupdf pillow
playwright install chromium # 首次需要,约 150MB
```
- 照片:人像,纯色或简洁背景最佳。**不需要抠图**——裁切由 CSS 完成
- **不要用 weasyprint 代替 playwright**:它在多数环境缺 libpango,且对 CSS flex 支持不全
- 没有照片也能跑,左栏会自动省掉照片区
## 工作流程
1. **读取素材** —— 用户给的 md / docx / 文本全部读一遍。docx 用 `python-docx`
2. **抽取成 YAML 并归档到 `data/`** —— 按下方数据契约整理。**这一步是语义判断,不要写解析器**:挑哪三条够格当徽章、把长 bullet 压成卡片两行、判断哪三项算「核心竞争力」,都是判断题
- **事实不得编造或美化**。原始材料里没有的,字段留空;数字、奖项名称、公司名逐字照抄
- 材料自相矛盾时**问用户**,不要自己选一个
- **创建即自动隔离**:用户标识从姓名推断(拼音)或询问。先一键建好隔离目录,再把 YAML 写进去——
```bash
# 在 data/<用户>/ 下建隔离目录 + 脚手架;有照片则一并拷入并自动设好 photo 字段
python scripts/render_user.py new <用户> [--photo 照片路径]
```
然后把抽取出的字段写回 `data/<用户>/me.yaml`(name 必填)。**不要让用户手动 mkdir/cp——简历一旦创建就自动罗盘到 `data/` 实现隔离。**
3. **渲染**
```bash
# 渲染 data/<用户>/me.yaml → 同目录 data/<用户>/(源与成品同处一文件夹,产物同样被 git 忽略)
python scripts/render_user.py <用户>
# 等价于:python scripts/render_resume.py data/<用户>/me.yaml
# (不传 -o 时,底层默认把 PDF/PNG/HTML 输出到 YAML 所在目录)
```
4. **亲自看一遍** —— 用 Read 工具打开生成的 PNG,确认没跑版、没截断、照片构图正常。**不要跑完脚本就说做完了**
5. **报告** —— 给出 PDF / PNG 路径,说明自检结果(页数、文字层字符数、缩放比例)
## 数据契约
除 `name` 外全部可选,**缺失即整段不渲染**(不留空标题、不留空白块)。
```yaml
na