md2resume-pitfalls · 简历转 DOCX 踩坑防护
md2resume-pitfalls skill：Markdown 简历转一页 DOCX 的故障模式防护层。与 md2resume 主 skill 配套使用：本 skill 是流程与踩坑层（字体污染、分页溢出、隐私泄露、tmp 脚本丢失、编辑器锁文件、交付物杂质），主 skill 是 Markdown 方言与渲染映射层。
核心规则：Markdown 是唯一内容源，参考 DOCX 只作版式骨架；交付物只能是一个检查过的 DOCX，PDF/PNG/HTML 如需视觉质检只在临时目录生成、交付前删除。含一页校准经验（scale 调整、压缩冗余文案优先于缩小字号）与模板字体修复（"Courier" 换 Arial，不动 "Courier New"）。
调用示例：在聊天框中说"把这份简历转成一页 DOCX，注意别踩坑"。
产品详解
定位
md2resume-pitfalls 是 Markdown 简历转一页 DOCX 的踩坑防护层：与 md2resume 主 skill 配套使用。本 skill 是流程与故障模式层，主 skill 是 Markdown 方言与渲染映射层。
核心能力
- 参考模板克隆路径：
build_docx_from_reference.py input.md --reference 模板.docx --output 输出.docx --scale X。 - 交付物纯净：只交付一个检查过的 DOCX；PDF/PNG/HTML 仅作临时视觉质检，交付前删除；不删源 Markdown、脚本与脱敏模板。
- 一页校准：内容变多后重测；先压缩冗余文案与段间距，再小步降
--scale（本项目经验：0.95 溢出、0.90 恰好一页）；正文字号不降到不可读。 - 模板与字体：保留模板的层级、蓝色线条、浅蓝成果条、左侧蓝条、照片位与页边距；每条加粗 1–2 个关键词，不整句加粗；fontTable 中的裸
"Courier"换Arial，"Courier New"不动；只高亮每段经历的最后一项成就。 - 隐私防护：确认提交的模板无真实姓名、电话、微信、邮箱、照片；真实照片只经外部
--reference文件传入，仓库内模板保持假名剪影。 - 锁文件处理：WPS/Word 打开目标文件时关闭或换输出名；路径可能被锁定时跑
check_output_ready.py。 - 页数验证：一页断言需经 Word/LibreOffice 渲染检查，不能从 Markdown 长度推断。
工作流程
- 检查源 Markdown、参考模板、输出路径（确认模板无真实隐私信息）
- 参考模板克隆构建（
--scale校准） - 验证内容、字体 XML、页数、视觉排版
- 清理交付目录（只留
.docx） - 交付
输入与输出
| 输入 | 说明 |
|---|---|
| Markdown 简历 | 必填，唯一内容源 |
| 参考模板 DOCX | 脱敏模板（假名、无真实联系方式与照片） |
| --scale | 一页校准参数 |
输出：单个检查过的 DOCX（输出目录只含 .docx）。
与相邻 skill 的区别
| skill | 分工 |
|---|---|
| md2resume-pitfalls（本） | 流程与踩坑防护层 |
| md2resume | Markdown 方言与渲染映射层（配套使用） |
适用场景
- 中文一页简历转 DOCX
- 模板字体污染、分页溢出等已知坑的规避
- DOCX-only 明确交付要求
使用前准备
- 准备 Markdown 简历与脱敏参考模板。
- 目标文件被 WPS/Word 打开时先关闭或换名。
md2resume-pitfalls 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。