Skip to content
Back to search

resume-builder

SkillWorks with Claude CodeGitHub

简历制作流水线:为求职 / 比赛 / 升学新建、完善或重组简历(中文 / 英文,1–2 页),覆盖对话收集→事实核对→撰写→画廊选模板→Typst 排版→浏览器可视化精修→导出 PDF,强调事实可溯源、不编造。触发词:简历、resume、CV、投简历、改简历。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stonell1--resume-builder/badge.svg)](/listings/stonell1--resume-builder)

HTML

<a href="/listings/stonell1--resume-builder"><img src="/api/listings/stonell1--resume-builder/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 89 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: resume-builder
  3. description: 简历制作流水线:为求职 / 比赛 / 升学新建、完善或重组简历(中文 / 英文,1–2 页),覆盖对话收集→事实核对→撰写→画廊选模板→Typst 排版→浏览器可视化精修→导出 PDF,强调事实可溯源、不编造。触发词:简历、resume、CV、投简历、改简历。
  4. ---
  5. # Resume Builder — 简历制作流水线
  6. ## 适用场景
  7. 用户要为某个具体目标(求职岗位 / 比赛 / 升学)制作中文或英文简历,或要把不同用途的简历分目录管理。
  8. ## 能力边界(不做什么)
  9. - 只做 **1–2 页**求职 / 比赛 / 升学简历。
  10. - 不做:三页及以上简历、多页学术 CV、求职信 / 推荐信、作品集 / 个人主页、手机和平板编辑。
  11. - 素材只通过对话提供(粘贴文字、口述、让 Agent 读本地 PDF);网页端不上传旧简历、PDF 或 JD。
  12. - 编辑器不内置 AI 对话、不做跨板块拖拽、不做快照回滚;所有数据只在本机,不调用云端接口。
  13. 超出范围就明示用户,另寻工具。
  14. ## 项目归档(每个用途一个独立目录)
  15. ```text
  16. <用途>/
  17. ├── resume.json ← 唯一内容数据源,Agent 与网页编辑器共同读写
  18. ├── resume.pdf ← 导出的正式交付物(姓名-目标岗位-电话.pdf)
  19. └── work/
  20. ├── 信息整理.md ← 素材库
  21. ├── claim-map.md ← 事实追溯表
  22. ├── session.json ← 阶段状态机(Agent 与本地服务协作)
  23. ├── events.jsonl ← 事件日志
  24. └── build/ ← 渲染中间产物,不作为交付物
  25. ```
  26. 用途目录之间互不联动。新建简历先建目录,再开始收集。
  27. ## 核心原则
  28. - **撰写前必读**:在撰写、改写、审计简历或针对 JD 定制之前,**必须完整阅读 [Resume-Writing-Guide-LLM.md](references/Resume-Writing-Guide-LLM.md)**,并按其方法进行内容取舍、证据表达与措辞调整。它是本 skill 写作方法论的唯一权威,也适用于模板适配时的压缩与润色;不能只读阶段说明就直接动笔。同一会话已完整读过后,后续按需回查,不必每轮重读。
  29. - **事实不可编造(最高优先级)**:决策链 `真实性 > 岗位匹配 > 证据强度 > 个人贡献 > 结果影响 > 可扫描性 > 文辞漂亮`。没有可靠数字时**不估算、不补造、不美化**,改用真实的上线、采用、验收、规模、交付物、决策影响或外部认可。
  30. - **强表述必须可举证**:`主导`、`Owner`、`独立负责`、`设计`、`优化` 等说法要有事实支撑;团队结果不得自动写成个人结果。
  31. - **目标决定取舍**:每份简历围绕一个明确的「背景 + 目的」,与目标无关的经历果断舍弃并说明理由。重包装 ≠ 编造。
  32. - **内容表达与排版质量**:内容清楚、有重点,版面饱满、均衡、易扫读。两者冲突时保留核心证据与可读性;不为排满页面增加空话、重复或无关内容。
  33. - **两阶段撰写**:先产出**模板无关**的完整内容稿;用户选定模板后,才做模板相关的压缩、排序、断行和页数控制。
  34. - **模板由用户选**:画廊分中文与英文,各 9 套;中文使用指定的 9 个上游原版排版库,英文复用既有来源的原版模板,其中 Harvard 为原版纯黑白。Agent 不替用户最终决定,也不自行重写模板版式。中英文各用其原版字体与布局,不做跨语言或双语适配。
  35. - **提问驱动完善**:缺口分优先级批量提问;用户说"跳过 / 没有"就接受,不反复追问。
  36. ## 事实与防幻觉(claim 追溯)
  37. 每份简历在 `<用途>/work/claim-map.md` 维护一张三列表,贯穿收集→撰写→导出全过程:
  38. | 简历内容 | 来源 | 状态 |
  39. |---|---|---|
  40. | 某某大学 某专业本科 | 原 PDF / 用户口述 | ✅ 已确认 |
  41. | 某项目 年化收益 X% | (待用户给出) | ⛔ 缺失阻塞 |
  42. 四态:**✅ 已确认**(可写入)· **❓ 待确认**(暂不写入,等确认)· **⛔ 缺失阻塞**(高危且缺失,必须先问清才能动笔)· **➖ 已省略**(经用户同意不写)。
  43. 高危类目(要么确认、要么经用户同意省略,绝不猜、不偷删):身份信息 · 学历 / 学校 · 雇主 / 公司 · 时间日期 · 论文 / 专利 · 量化数字 · 照片取舍。
  44. claim-map 由 Agent 在对话中维护;网页端只读展示,不自动改状态。
  45. ## 阶段流程与阅读路由
  46. ```text
  47. A 对话收集与模板无关撰写 → B 模板选择(画廊)→ C 模板适配与正式排版
  48. → D 可视化精修(编辑器)→ F 正式导出
  49. D 中用户换模板 → E 重新排版检查 → 回 D
  50. ```
  51. | 阶段 | Agent 做什么 | 进入时读取 |
  52. |---|---|---|
  53. | A | 收集素材、确认目标、claim-map、缺口提问、模板无关内容稿 | `references/writing-stage.md`(首次调用即读) |
  54. | B | 启动本地画廊,等用户选模板,自动获取结果 | `references/template-selection.md` |
  55. | C | 按所选模板二轮精修,写入 `resume.json`,渲染并检查 | `references/rendering-stage.md` + `references/data-contract.md` |
  56. | D | 与网页编辑器协作精修(双方改同一份 JSON) | `references/editor-stage.md` |
  57. | E | 针对新模板重新排版和检查 | `references/rendering-stage.md` 的换模板一节 |
  58. | F | 终检后引导导出规范命名 PDF | `references/editor-stage.md` 的导出一节 |
  59. - 服务器、前端、模板语法、Typst 排错细节全部放在上表按需文件里,主入口不展开。**阶段 A 不启动任何服务、不讨论模板与排版实现。**
  60. - **运行与恢复**:Windows 使用 `scripts/run.ps1`、macOS 使用 `scripts/run.sh` 调用服务和脚本,或使用 bootstrap 输出的解释器绝对路径。默认只装基础运行时,选模板后按需准备字体。首次渲染失败读取具体错误,不连续盲目重试;详见阶段 B/C。
  61. - **日常制作只检查当前简历**:内容与版面检查按 `references/rendering-stage.md` §4 执行,已检查且未变化的部分不重复检查。发布版不附带开发测试流程。
  62. - **恢复旧项目**:先看 `work/session.json` 的 `stage` 字段,按上表路由到对应阶段文件继续。模板退役或语言不匹配时回画廊让用户重选;不得静默换模板。
  63. ## 何时进入模板选择(Agent 自行判断,不问用户"该进下一步吗")
  64. 同时满足以下条件即告知用户"素材已充分,即将进入模板选择",然后读 `references/template-selection.md`:
  65. 1. 内容稿覆盖全部拟保留板块与条目,无占位空壳;
  66. 2. claim-map 中 **⛔ 缺失阻塞清零**(已确认,或经用户同意记 ➖);
  67. 3. 关键 ❓ 已确认过一轮(影响定稿的都问过);
  68. 4. 用户暂无新增信息。
  69. ## 信息安全(硬性要求)
  70. - skill 文件、任何"模板 / 示例 / 流程"内容中**不得出现真实姓名、电话、邮箱、学校、公司等个人数据**,一律占位符脱敏。
  71. - 用户真实数据只存在于其自己的用途目录中,不回灌进 skill。
  72. - 第三方原始源码与许可证保留其上游署名;其中公开示例仅用于来源审计,不注入用户简历。画廊按用户要求使用上游公开预览原图;上游公开示例仅供展示,不注入用户数据。
README.md · README · 213 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">resume-builder</h1>
  2. <p align="center">从真实经历出发,让 Agent 问到重点,写出可投递的简历。</p>
  3. <p align="center">
  4. <a href="#screenshots"><img src="https://img.shields.io/badge/Templates-18-4D8BC4?style=flat-square" alt="18 resume templates"></a>
  5. <a href="INSTALL.md"><img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-555555?style=flat-square" alt="Windows and macOS"></a>
  6. <a href="references/rendering-stage.md"><img src="https://img.shields.io/badge/Rendering-Typst-239DAD?style=flat-square" alt="Rendered with Typst"></a>
  7. <a href="#licenses"><img src="https://img.shields.io/badge/Original_code-MIT-555555?style=flat-square" alt="Original code licensed under MIT; see third-party notices"></a>
  8. </p>
  9. <p align="center"><strong>简体中文</strong> · <a href="README.en.md">English</a></p>
  10. <p align="center"><a href="#quick-start">快速开始</a> &nbsp;·&nbsp; <a href="#whats-new">What's New</a> &nbsp;·&nbsp; <a href="#screenshots">模板预览</a> &nbsp;·&nbsp; <a href="#docs">文档</a></p>
  11. <p align="center">
  12. <img src="cover.png" width="800" alt="resume-builder — 将真实经历打磨成专业简历">
  13. </p>
  14. **resume-builder 是一个从素材收集到 PDF 交付的 Agent Skill。** 你提供旧简历、目标岗位或零散经历,Agent 主动追问、核对事实、组织内容,再带你选模板、在浏览器中精修。
  15. 写作方法论**蒸馏自近百篇小红书高赞简历经验帖**,覆盖中文与英文的 1–2 页求职、实习、比赛和升学简历。你不必先学会写简历,才能开始写简历。
  16. <a id="whats-new"></a>
  17. ## What's New
  18. | 新能力 | 使用体验 |
  19. | :--- | :--- |
  20. | **18 套中英文模板** | 中文 9 套、英文 9 套;在画廊中查看完整预览,再选择版式。 |
  21. | **浏览器可视化精修** | 点击文字编辑,增删经历与要点,在同一板块内拖拽排序。 |
  22. | **Typst 实时排版** | 保存后重新渲染,查看实际页数,导出规范命名的 PDF。 |
  23. | **对话与网页协作** | 内容可在 Agent 与编辑器之间继续调整;先写内容,再按模板精修。 |
  24. | **事实追溯与核对** | 查看表述来源,筛选已确认、待确认、缺失阻塞和已省略的内容。 |
  25. ![可视化编辑器:左侧查看 Typst 实际渲染结果,右侧调整简历结构](assets/screenshots/editor.png)
  26. <p align="center"><sub>真实本地界面 · 虚构演示素材 · 保存后自动重新排版</sub></p>
  27. <a id="quick-start"></a>
  28. ## 快速开始
  29. ### 1. 让 Agent 安装
  30. 将以下内容发送给能够读写本地文件、执行命令并加载 `SKILL.md` 的 Agent:
  31. ```text
  32. Fetch and follow instructions from:
  33. https://raw.githubusercontent.com/StoneLL1/resume-builder/main/INSTALL.md
  34. ```
  35. [INSTALL.md](INSTALL.md) 面向 Agent,包含目录探测、部署、依赖准备与验证。Windows / macOS 提供自动引导脚本,无需 Node.js 或 XeLaTeX。
  36. ### 2. 带上材料,开始对话
  37. ```text
  38. 请使用 resume-builder,针对这份 JD 帮我制作一页中文简历。
  39. 我会提供旧简历和补充经历。请主动追问缺失信息,核对事实后再撰写;
  40. 内容充分后打开模板画廊,让我选择版式并在网页中精修。
  41. ```
  42. 旧简历、JD 和补充材料直接通过对话提供。Agent 会在内容充分后打开网页,你无需逐步安排整个流程。
  43. <a id="features"></a>
  44. ## 为什么用 resume-builder
  45. ### 会主动问,才写得具体
  46. “参与过项目”只是起点。Agent 会围绕目标筛选素材,通常每批追问 **3–6 个问题**,逐步挖掘职责、难点和成果。例如:
  47. > **你:** 参与过校园报名系统开发。<br>
  48. > **Agent 会进一步确认:** 哪部分由你独立完成?解决了什么实际问题?有没有上线、使用记录或验收结果?
  49. 回答会进入事实记录,再用于撰写。明确说“没有”“跳过”或“不写”的内容不会被反复追问。
  50. ### 小红书经验,变成可执行的写作规则
  51. 经验已沉淀在 Agent 动笔前必读的 [完整写作指南](references/Resume-Writing-Guide-LLM.md) 中,使用时无需登录小红书。核心只保留四件事:
  52. - **围绕目标取舍**:优先展示相关且有证据的经历。
  53. - **写清个人贡献**:问题 → 个人动作 → 结果,不堆职责清单。
  54. - **先有证据,再谈量化**:没有可靠数字,就写上线、采用、验收和交付物。
  55. - **经得起面试追问**:不虚构经历,不放大角色,不把团队成果全算给自己。
  56. ### 内容先行,排版随后
  57. 先形成与模板无关的内容稿,再根据所选版式精修;换模板后重新检查。项目独立保存,关闭浏览器后可继续编辑,最终交付可投递的 PDF。
  58. <a id="screenshots"></a>
  59. ## 模板与界面
  60. ### 选版式,先看实际效果
  61. | 中文 · 9 套 | 英文 · 9 套 |
  62. | :---: | :---: |
  63. | ![中文模板画廊](assets/screenshots/gallery-zh.png) | ![英文模板画廊](assets/screenshots/gallery-en.png) |
  64. 保留上游布局与字体,支持完整大图预览。Harvard 提供纯黑白版式。所有截图的素材与来源见 [截图说明](assets/screenshots/README.md)。
  65. <details>
  66. <summary><strong>查看全部 18 套模板</strong></summary>
  67. | 分类 | 模板 |
  68. | :--- | :--- |
  69. | 中文 | OrangeX4、Chi CV 原版 / 中文版、Resume NG、Miku CV、Qianxi、Unique CV、Habaneraa、SweetGargamel |
  70. | 英文 | RenderCV Classic / ModernCV / Harvard / Ink / Opal、Basic Resume、ImpreCV、Modern CV、Index CV |
  71. 固定版本、来源、字体要求与适配差异见 [模板注册表](assets/templates/registry.md)。切换画廊分类不会修改正文;跨语言选定模板后,由 Agent 翻译、精修与核验。
  72. </details>
  73. <details>
  74. <summary><strong>查看文字块编辑与事实核对</strong></summary>
  75. **文字块编辑** · 点击预览中的字段修改,支持加粗和链接,保存后重新排版。
  76. ![就地编辑简历文字块](assets/screenshots/inline-edit.png)
  77. **事实核对** · 查看来源与四种确认状态,由 Agent 在对话中维护。
  78. ![事实核对与状态筛选](assets/screenshots/facts.png)
  79. </details>
  80. ## 从素材到交付
  81. ```mermaid
  82. flowchart LR
  83. A[目标与素材] --> B[主动追问 · 核对 · 撰写]
  84. B --> C[选择模板 · 网页精修]
  85. C --> D[终检 · PDF 导出]
  86. C -->|换模板后复核| C
  87. ```
  88. 网页精修完成后,点击 **「完成」** 通知 Agent 终检,再通过 **「导出 → 导出正式 PDF」** 生成 `姓名-目标岗位-电话.pdf`;缺少电话时省略该部分。
  89. <a id="docs"></a>
  90. ## 文档
  91. | 入口 | 内容 |
  92. | :--- | :--- |
  93. | [安装说明](INSTALL.md) | Agent 安装、依赖准备、验证与 runner 接入 |
  94. | [Skill 入口](SKILL.md) | Agent 行为约定与阶段路由 |
  95. | [写作指南](references/Resume-Writing-Guide-LLM.md) | 按岗位与经历类型组织的写作方法论 |
  96. | [模板注册表](assets/templates/registry.md) | 18 套模板、上游来源与许可 |
  97. | [数据契约](references/data-contract.md) | 简历数据、事实记录与项目目录约定 |
  98. <details>
  99. <summary><strong>项目结构</strong></summary>
  100. ```text
  101. resume-builder/
  102. ├── SKILL.md # Agent 入口
  103. ├── INSTALL.md # Agent 安装流程
  104. ├── README.md / README.en.md # 中文 / 英文介绍
  105. ├── cover.png # 原始封面
  106. ├── references/ # 写作指南与阶段说明
  107. ├── scripts/ # 安装、服务、渲染与校验
  108. ├── tests/ # HTTP 回归测试
  109. └── assets/ # 模板、网页、依赖与截图
  110. ```
  111. 每个用途在 skill 之外另建目录,保存 `resume.json`、正式 PDF,以及 `work/` 下的素材、事实追溯表、会话状态和构建文件。
  112. </details>
  113. ## 常见问题
  114. <details>
  115. <summary><strong>支持哪些 Agent 和平台?</strong></summary>
  116. Agent 需要能读写本地文件、执行命令并加载 `SKILL.md`。Claude Code、Codex 按各自技能目录接入;OpenClaw、Hermes 等使用其实际 runner 配置。自动安装覆盖 Windows 与 macOS,当前没有 Linux 安装清单。部分模板需要本机原版字体,详见 [INSTALL.md](INSTALL.md)。
  117. 当前面向桌面浏览器,支持中文或英文单语 1–2 页简历;不支持手机 / 平板编辑、双语混排、求职信、作品集和多页学术 CV。
  118. </details>
  119. <details>
  120. <summary><strong>数据存在哪里?整个流程都离线吗?</strong></summary>
  121. 简历内容与会话状态保存在本地,网页服务仅监听 `127.0.0.1`。默认首次安装只准备运行时,开放字体按所选模板安装;模板与 Typst 包随项目提供。仅有中国大陆网络时,可按 [安装说明](INSTALL.md) 在可联网机器准备离线安装包后转移安装。Agent 对话中的数据处理取决于所用 Agent 和模型服务,本地网页不代表整个 AI 工作流离线。
  122. </details>
  123. <details>
  124. <summary><strong>网页编辑和事实核对有什么边界?</strong></summary>
  125. Agent 与编辑器共享 `resume.json`;同时编辑时以后保存的内容为准,不自动合并冲突。当前没有历史快照回滚、跨板块拖拽、网页上传材料或内置 AI 聊天。
  126. Agent 只使用已确认事实撰写;网页只读展示事实状态,修改措辞不会自动确认事实。导出按钮不拦截未确认项,真实性由写作流程和终检把关。
  127. </details>
  128. <a id="licenses"></a>
  129. ## Star History
  130. <a href="https://www.star-history.com/?repos=stonell1%2Fresume-builder&type=date&legend=top-left">
  131. <picture>
  132. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=stonell1/resume-builder&type=date&theme=dark&legend=top-left" />
  133. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=stonell1/resume-builder&type=date&legend=top-left" />
  134. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=stonell1/resume-builder&type=date&legend=top-left" />
  135. </picture>
  136. </a>
  137. ## 致谢与许可
  138. 感谢小红书简历经验分享者,以及开源模板、Typst、字体与图标项目的维护者。
  139. 项目原创部分采用 [MIT 许可证](LICENSE)。第三方资产遵循各自许可,详见 [模板注册表](assets/templates/registry.md)、各模板的 `ATTRIBUTION.md` 和 [运行时说明](assets/runtime-NOTICES.md)。OrangeX4、Chi CV 中文版和 Unique CV 的固定上游版本未声明独立许可证,记录为 `NOASSERTION`,不由本项目 MIT 授权覆盖。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.