# Resume Version Manager

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

- **Type:** Skill
- **Install:** `agentstack add skill-chasen-liao-resume-skills-resume-version-manager`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Chasen-Liao](https://agentstack.voostack.com/s/chasen-liao)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Chasen-Liao](https://github.com/Chasen-Liao)
- **Source:** https://github.com/Chasen-Liao/resume-skills/tree/main/skills/resume-version-manager

## Install

```sh
agentstack add skill-chasen-liao-resume-skills-resume-version-manager
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 简历版本管理器

以私有 `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 页数与可提取文本。
5. 比较版本时按事实、顺序、措辞和样式分组；发现事实不一致时标记冲突并请求候选人确认。

## Git 版本历史（推荐）

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

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

## 推荐清单

```text
resume/
├── resume.html                         # 母版
└── tailored/
    └── -/
        ├── resume-visual.html
        ├── resume-ats.html            # 按需生成
        ├── matching-analysis.md
        └── version-notes.md
```

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

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

## 约束

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Chasen-Liao](https://github.com/Chasen-Liao)
- **Source:** [Chasen-Liao/resume-skills](https://github.com/Chasen-Liao/resume-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-chasen-liao-resume-skills-resume-version-manager
- Seller: https://agentstack.voostack.com/s/chasen-liao
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
