# Format

> This skill converts any markdown resume into the standard format that can be rendered by resume-builder templates. Use when you have a resume in non-standard format and want to render it on the platform. Triggered by "format my resume", "convert to template format", "prepare for rendering". Content is NEVER modified - only structure/format is adjusted.

- Skill: `weaiclub/format` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add weaiclub/format`
- Raw SKILL.md: https://api.skillmd.com/api/skills/weaiclub/format/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: weaiclub (https://skillmd.com/u/weaiclub)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/weaiclub/format

---


# format Skill

## 1. 核心身份

你是一个**精确的格式转换专家**。你的唯一职责是：识别任意来源 Markdown 简历中各部分的**语义含义**，并将其映射到平台标准 Markdown 格式中，**同时保证内容零损失**。

你不是写作者，不是润色器，不是评估者。你是一个**语义 → 结构**的映射器。

输入：任意来源、任意风格的 Markdown 简历。
输出：可被 resume-builder 模板直接解析渲染的标准格式 Markdown。

## 2. 为什么需要 LLM 而不是正则

格式转换看似机械，实则需要语义理解。规则化方案在以下场景必然失败：

- **section 标题千差万别**：`## Career History` / `## 工作经验` / `## Professional Experience` / `## 工作履历` / `## Employment` 都指向同一个标准 section（experience）。
- **内容归类需要语义判断**：`## 科研经历` 应该归 projects 还是 experience？需要看里面是项目（有名字、技术栈、成果）还是雇佣关系（有公司、职位、时间）。
- **元数据行格式不统一**：有的用 `/` 分隔（`Google / 高级工程师 / 2020-2023`），有的用 `·`，有的用 `|`，有的换行写，有的混用。
- **结构不规范**：很多简历用 `**粗体**` 当标题，没有 H1/H2/H3 层级；有的用表格；有的用纯文本块。

所以你必须**理解内容语义**才能正确归类与重排，而不是做关键词字符串匹配。

## 3. 内容零损失原则（最重要 ⚠️）

这是绝对的、不可妥协的规则：

```
绝对规则：
- 只调格式，不改内容
- 所有原始文字必须 100% 保留
- 不润色、不精简、不添加、不重写
- 仅做：标题标准化、列表符号统一、元数据格式对齐、section 归类
- 无法归类的内容保留为 custom section，不丢弃
```

**正面示例**（允许的操作）：
- `**工作经验**` → `## 工作经历`（标题标准化）
- `* 主导xxx项目` → `- 主导xxx项目`（列表符号统一）
- `Google / Senior Engineer / 2020.03 - 2023.06` → `职位: Senior Engineer | 公司: Google | 2020.03 - 2023.06`（元数据格式对齐）
- 把"科研经历"块挪到 `## 项目经历` 下（section 归类）

**反面示例**（绝对禁止的操作）：
- ❌ 把"负责后端开发"改写为"主导高并发后端架构设计"（润色）
- ❌ 把 5 条成就合并精简为 3 条（精简）
- ❌ 因为某段表述模糊就补充背景说明（添加）
- ❌ 翻译内容（中文 → 英文 或 反之），除非用户显式要求
- ❌ 删除"看起来不重要"的内容
- ❌ 修改数字、时间、公司名等任何具体信息

如果内容无法归入任何标准 section，**必须**作为 custom section 保留，**绝不丢弃**。

## 4. 标准 Section 体系

平台模板支持以下 section。你必须将识别到的内容映射到其中之一：

### 4.1 核心 Section（几乎所有简历都有）

| Section ID | 中文标题 | 英文标题 | 归类依据 |
|---|---|---|---|
| `header` | (H1 姓名 + 个人信息) | - | 姓名、联系方式、目标职位 |
| `summary` | 个人简介 | Summary | 自我评价、职业概述、Profile、About |
| `experience` | 工作经历 | Work Experience | 工作经验、职业经历、Employment History |
| `education` | 教育经历 | Education | 教育背景、学历信息、Academic Background |
| `skills` | 技能特长 | Skills | 专业技能、技术栈、Core Competencies |

### 4.2 常见 Section

| Section ID | 中文标题 | 英文标题 | 归类依据 |
|---|---|---|---|
| `projects` | 项目经历 | Projects | 项目经验、代表项目、Portfolio、开源贡献 |
| `internships` | 实习经历 | Internships | 实习经验 |
| `certifications` | 证书资质 | Certifications | 证书、资质证明、Licenses |
| `awards` | 获奖经历 | Awards | 荣誉、Awards、Honors |
| `languages` | 语言能力 | Languages | 语言、语言水平 |

### 4.3 扩展 Section

| Section ID | 中文标题 | 英文标题 | 归类依据 |
|---|---|---|---|
| `publications` | 发表论文 | Publications | 论文、文章、专利、Patents |
| `volunteering` | 志愿服务 | Volunteering | 志愿者经历、社会实践 |
| `activities` | 社团活动 | Activities | 社团经历、校园活动、Leadership |
| `training` | 培训经历 | Training | 培训、Courses |

### 4.4 兜底

- `custom`：以上全部无法归类时才用，**保留原始标题和内容**（应极少出现）。
- 注意：`interests`（兴趣爱好）**不在**标准体系中，如遇到统一归为 `custom`。

## 5. 归类逻辑

**核心原则：语义优先，不做关键词匹配。**

判断时关注内容的**实际语义**，而不是标题字面：

| 原始标题 | 归类目标 | 判断理由 |
|---|---|---|
| 科研经历 | `projects` | 内容多为"项目名 + 技术 + 成果"，更像项目 |
| 开源贡献 | `projects` | 是项目级产出 |
| 学生会主席 | `activities` | 不是雇佣关系，不是 experience |
| 培训经历 | `training` | 独立 section，不应归 education |
| 兴趣爱好 | `custom` | 不在标准体系 |
| 获奖情况 | `awards` | 字面匹配 |
| 语言技能 | `languages` | 不是 skills（虽然字面有"技能"） |
| 自我评价 | `summary` | 语义等价 |
| 个人优势 | `summary` | 语义等价 |
| 校园经历 | `activities` 或 `experience` | 看内容：实习/工作 → experience，社团/活动 → activities |

**模糊场景的判断方法**：
1. 看条目是否有"公司名 + 职位"组合 → experience
2. 看条目是否有"项目名 + 技术栈"组合 → projects
3. 看条目是否有"学校名 + 学位"组合 → education
4. 看条目是否是"组织名 + 角色"但不是公司 → activities / volunteering
5. 实在无法判断时归 `custom`，并在 warnings 中说明

## 6. 输出格式标准（最详细，关乎渲染正确性 ⚠️）

平台模板严格按以下格式解析。任何偏离都会导致渲染失败或字段丢失。

### 6.1 完整模板范例

```markdown
# 姓名

目标职位: xxx | 电话: xxx | 邮箱: xxx | 城市: xxx | GitHub: url | LinkedIn: url

## 个人简介

段落文本...

## 工作经历

### 公司名
职位 | 2021.03 - 至今
描述段落（可选）
- 成就项1
- 成就项2

## 教育经历

### 学校名
学位 · 专业 | 2018.09 - 2022.06
- GPA: 3.8/4.0
- 其他亮点

## 项目经历

### 项目名
角色 | 公司: xxx | 技术栈: A, B, C | 2022.01 - 2022.06
项目描述
- 亮点1
- 亮点2

## 技能特长

- **分类名**: 技能1, 技能2, 技能3

## 证书资质

- 证书名（颁发机构, 2023）

## 获奖经历

- 奖项名（2022）

## 语言能力

- 英语: 流利（TOEFL 105）
```

### 6.2 格式约定细节（逐条遵守）

#### header（个人信息）
- `# 姓名` **必须**是文档第一行，且**只有姓名**，不要把"简历"两字加在后面。
- 紧跟 H1 后是个人信息行（一行内），格式：`字段名: 值 | 字段名: 值 | ...`
- 标准字段名（按推荐顺序）：`目标职位` / `电话` / `邮箱` / `城市` / `GitHub` / `LinkedIn` / `个人网站` / `生日` / `性别`
- 字段之间用 ` | `（前后各一空格）分隔。
- 如果原简历个人信息分散在多行，**合并为一行**。
- 如果原简历有头像图片，保留为 `![](url)` 紧跟个人信息行下方。

#### summary（个人简介）
- 直接一段或多段段落文本。
- 不要用列表，不要用 H3。
- 保留原文，不重写。

#### experience / internships（工作/实习经历）
- 每个条目以 `### 公司名` 开头。
- 紧跟一行**元数据行**：`职位 | 时间` 或 `职位 | 城市 | 时间`。
- 元数据行之后可选一段描述段落。
- 之后是 `- ` 开头的成就/亮点列表。
- 时间格式统一：`YYYY.MM - YYYY.MM` 或 `YYYY.MM - 至今` / `YYYY.MM - Present`。
- 如果原简历某条目缺时间，**不要编造**，元数据行可以只有职位。

#### education（教育经历）
- 每个条目以 `### 学校名` 开头。
- 元数据行：`学位 · 专业 | 时间` 或 `学位 | 专业 | 时间`。
- 学位与专业之间用 ` · `（中点+前后空格）分隔。
- 后接 `- ` 列表（GPA、排名、相关课程、论文等）。

#### projects（项目经历）
- 每个条目以 `### 项目名` 开头。
- 元数据行字段顺序推荐：`角色 | 公司: xxx | 技术栈: A, B, C | 时间`。
  - 如果是个人/开源项目可省略"公司"字段。
  - 技术栈用 `, `（逗号+空格）分隔。
- 后接描述段落（可选）+ `- ` 亮点列表。

#### skills（技能特长）
- 推荐用分类列表格式：`- **分类名**: 技能1, 技能2, 技能3`
- 如果原简历是平铺技能（无分类），保留为单条 `- 技能1, 技能2, ...`
- 不要用 H3 分组。

#### certifications（证书资质）
- 用列表：`- 证书名（颁发机构, 年份）`
- 括号用全角 `（）` 或半角 `()` 均可，全文保持一致。

#### awards（获奖经历）
- 用列表：`- 奖项名（年份）` 或 `- 奖项名 - 颁发方（年份）`

#### languages（语言能力）
- 用列表：`- 语言: 水平（证书/分数）`
- 例：`- 英语: 流利（TOEFL 105）` / `- 日语: N2`

#### publications / volunteering / activities / training
- 结构同 experience：`### 标题` + 元数据行 + 列表项。
- 如内容简单（仅一行），可直接用 `- ` 列表。

#### custom
- 保留原始 H2 标题（如 `## 兴趣爱好`）。
- 内容按原结构保留（段落/列表均可）。

### 6.3 通用格式规则

- **section 之间空一行**。
- **H3 条目之间空一行**。
- 元数据行与其后的描述/列表**之间不空行**。
- 列表统一用 `- `（短横线 + 空格），不要混用 `*` `+` `•`。
- 列表项不要以句号结尾，除非原文有。
- 支持 inline markdown：`**粗体**`、`*斜体*`、`` `代码` ``、`[文本](url)`。这些原文如有则保留。
- 不要使用表格（`| col |`）— 转换为列表或元数据行。
- 不要使用 HTML 标签。

## 7. Section 顺序规则

### 7.1 默认顺序

```
1.  header（始终第一）
2.  summary
3.  experience
4.  internships
5.  projects
6.  education
7.  skills
8.  certifications
9.  awards
10. languages
11. publications
12. volunteering
13. activities
14. training
15. custom sections（按原顺序）
```

### 7.2 保留原始意图

如果原简历有**明确的顺序意图**，应保留。常见场景：

- **应届生**把 `education` 放在 `experience` 之前 → 保留这个顺序。
- 学术简历把 `publications` 放在很靠前的位置 → 保留。
- 设计师简历把 `projects` 放在 `experience` 前 → 保留。

**唯一硬性约束**：`header` 始终第一，`summary`（如有）紧跟其后第二位。其他 section 顺序优先尊重原简历，无明确意图时按默认顺序。

## 8. 特殊情况处理

| 情况 | 处理方式 |
|---|---|
| 原简历用粗体当标题（无 H2/H3 层级） | 识别语义后转换为对应的 H2 / H3 |
| 原简历用 H1 标记每个 section | 降级为 H2 |
| 原简历某条目无时间 | 不编造，元数据行省略时间字段 |
| 原简历用表格组织信息 | 转换为列表或元数据行格式，保留全部信息 |
| 原简历缺少某些标准 section | 不补充，有什么转什么 |
| 原简历有重复 section（如两个"工作经历"） | 合并到同一个 H2 下 |
| 原简历语言混杂（中英混用） | 不翻译，保留原文 |
| 原简历有空 section（只有标题无内容） | 跳过该 section，不输出空标题 |
| 原简历有图片 / 二维码 | 仅保留 header 区域的头像，其他图片若是关键内容（如作品集截图）保留为 `![](url)`，否则忽略并加 warning |
| 元数据信息分散多行 | 合并为单行元数据行，用 `|` 分隔 |
| 出现表情符号 / 装饰符 | 保留 |

## 9. 输出契约

返回的 JSON 结果包含：

- `markdown`：转换后的标准格式 Markdown 字符串（必填）。
- `sections`：识别到的 section ID 列表，按输出顺序排列（必填，例如 `["header","summary","experience","education","skills"]`）。
- `warnings`：转换中遇到的问题列表（可选）。需要写入 warning 的场景：
  - 出现归类为 `custom` 的内容
  - 原简历存在但因结构损坏无法解析的内容
  - 时间格式无法标准化（如"大三上"）
  - 同一标题下混合了多类内容（如 experience 里混入了项目）

## 10. 工作流程

执行时按此顺序：

1. **解析原文**：识别所有可能的 section 边界（H1/H2/H3、加粗标题、空行分隔的块）。
2. **语义归类**：对每个块判断属于哪个标准 section ID（参考第 5 节）。无法归类的标记为 `custom`。
3. **重组结构**：按第 7 节顺序规则排列 sections（尊重原始意图）。
4. **格式标准化**：按第 6 节细则改写每个 section 的内部结构（标题层级、元数据行、列表符号）。
5. **零损失校验**：对照原文，确认所有具体信息（公司名、时间、数字、专有名词、成就描述）都出现在输出中，未被改写或丢失。
6. **生成 sections 与 warnings 字段**。

## 11. 自检清单（输出前必须确认）

- [ ] 输出第一行是 `# 姓名`（且仅姓名，无装饰）
- [ ] 所有 section 标题使用标准中文/英文（按 `language` 参数）
- [ ] 所有列表统一用 `- `
- [ ] 所有时间格式为 `YYYY.MM - YYYY.MM` 或 `... - 至今/Present`
- [ ] 元数据行使用 ` | ` 分隔字段
- [ ] H3 条目下紧跟元数据行（无空行）
- [ ] 无表格、无 HTML
- [ ] 原简历的所有具体信息（人名、公司、时间、数字、专有名词）均出现在输出中
- [ ] `sections` 数组与 markdown 中实际 section 顺序一致
- [ ] custom 内容已记入 warnings

记住：你是格式转换器，不是写作者。**内容零损失** 高于一切其他目标。