# Resume Version Manager

> 管理简历母版及针对不同公司、岗位和 JD 的定制版本。当用户要保存多个简历版本、比较差异、命名文件、回溯投递版本或维护简历事实源时使用。保护母版，不覆盖已有版本或未经确认的事实。

- Skill: `chasen-liao/resume-version-manager` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chasen-liao/resume-version-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chasen-liao/resume-version-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: chasen-liao (https://skillmd.com/u/chasen-liao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chasen-liao/resume-version-manager

---


# 简历版本管理器

以私有 `resume-facts.yaml` 为唯一事实源，为每次投递建立可回溯、可比较的母版和定制版本。HTML/PDF 是从已确认事实生成的交付物，不替代事实记录。

它不占用用户的主流程入口：在母版确认或 JD 定制版确认后记录版本即可；用户需要比较、恢复或维护投递记录时再展示版本操作。

## 先读

读取 [简历事实契约](../resume-builder/references/resume-contract.md)、[JD 匹配报告模板](../jd-tailorer/references/matching-analysis.md) 和 [写作规范](../resume-builder/references/content-writing.md)。

## 工作流

1. 找到或创建私有 `resume-facts.yaml` 和明确标识的母版；事实文件保存候选人全部已确认的 claim，不能被定制操作覆盖。
2. 为一个公司/岗位/JD 创建独立目录：`tailored/<公司名>-<岗位>/`。
3. 记录父版本、目标 JD、创建日期、使用的候选人事实、重排项、改写项、关键词来源、未匹配要求和待确认字段。
4. 生成该版本的 `resume_visual.html`，必要时生成 `resume_ats.html` 和 `matching-analysis.md`；验证 PDF 页数、可提取文本和 HTML 溢出，并只记录 hash 对应当前文件的 valid manifest。
5. 比较版本时按事实、顺序、措辞和样式分组；发现事实不一致时标记冲突并请求候选人确认。

## Git 版本历史（推荐）

将 `resume/` 放在**本地私有 Git 仓库**中，用提交记录确认后的事实和投递版本；不要默认推送到公开远程仓库，简历可能包含联系方式和其他个人信息。

- 候选人确认母版变更后，创建一次说明明确的提交，例如：`更新母版：补充 RAG 项目`。
- 每次确认生成一份定制版后，创建一次提交，例如：`定制：字节跳动 - 前端实习生`。
- 比较、恢复或审计时，以提交差异为准；比较范围仍按事实、顺序、措辞和样式分组，并优先确认事实冲突。
- 只有候选人希望同时尝试互斥的母版方向时，才创建分支；普通的 JD 定制保存在 `tailored/` 目录并用提交追溯即可。
- 不自动执行 Git 初始化、提交、推送或覆盖；在每个会改变版本历史的操作前说明范围并取得候选人确认。

## 推荐清单

```text
resume/
├── resume.html                         # 母版
└── tailored/
    └── <公司名>-<岗位>/
        ├── resume_visual.html
        ├── resume_visual.pdf
        ├── resume_ats.html            # 按需生成
        ├── resume_ats.pdf             # 按需生成
        ├── matching-analysis.md
        └── version-notes.md
```

`version-notes.md` 最少记录：父版本、所用 `resume-facts.yaml`、JD 来源/日期、变更摘要、关键词来源、未匹配要求、待确认字段和导出验证结果。

若使用 Git，`version-notes.md` 还应记录对应提交 ID，便于从定制版回到母版事实和生成依据。

## 约束

- 定制版只能重排、强调或改写已确认事实；回写母版需要用户明确要求。
- 命名可使用 `姓名_岗位_公司_YYYYMM.pdf`，但以目标平台要求为准。
- 不通过删除历史版本、静默覆盖文件或伪造版本记录来“整理”工作区。