zgs-ppt：职规赛展示 PPT 的框架与成稿

把"选手的一堆材料"变成一份每页只讲一个论点、且撑得住追问的展示 PPT。先出大纲，人点头，自检通过，再出 .pptx。

设计原则（三条，贯穿全程）

1. 大纲先行，一次只改一处：内容质量在大纲阶段解决，渲染只做视觉翻译。用户的修改意见永远落回 outline.json 再重跑，不直接改 pptx——改了 pptx 下次重跑就丢。
2. 每页撑得住一次追问：页面是答辩的靶子，不是排版的容器。一页如果答不出"所以呢"和"凭什么"，这页就不该存在。
3. 阅读型，不是演讲型：评委自己翻也能读完论点与证据；口播只做导引。任何一页脱离口播就读不懂，必须改，不能靠讲。

0 产物与文件索引

不做的：不打分（zgs-review）、不出题库（zgs-qa）、不写逐字稿正文（只给每页口播要点）、不代写生涯发展报告与简历。

文件索引——何时读哪一份：

1 输入：先判断材料够不够

材料是 PDF/DOCX/PPTX/MD/TXT 时，先跑：

python3 scripts/extract_content.py <材料文件> <输出.txt>

抽取结果带页码锚点（P 3 / 幻灯片 5），写大纲时用它标"证据出自哪一页"，方便回查。

提取失败就停，不要假装材料里没有内容：

2 定组别与页数预算

页数由组别决定，不由材料多少决定。所有组别 15–20 页（下限 15，上限 20）：

页数上调的代价要讲清楚：7 分钟 17 页每页只有 25 秒，6 分钟 16 页只有 22 秒——这已经不是"演讲"的节奏，而是"评委自己看、你只做导引"的节奏。

页数上调后多出来的 3–5 页，优先补这四类（不是把每页拉长，而是补此前被挤掉的页）：

1. 岗位调研实录（拆了几份 JD、访谈了几人、得出什么结论）——评委最爱追问，也最容易被省；
2. 人岗匹配度（匹配进度图，含未达标项）——主动认缺口的落点；
3. 二次证据页（证书墙／台账／现场照，把硬证据集中放一处）；
4. 风险预案（竞争、技术迭代、家庭约束 + 对策）——就业赛道的"发展潜力"、成长赛道的"优化改进"都靠它落地。

若组别是职教（Z2/Z5），另加"安全与规范"独立页；若选手目标是海外/驻外岗，另加"家庭与地域约束"页。

3 写大纲：outline.json 是唯一事实源

3.1 单一源纪律（最容易出错的一步）

outline.json 与 -大纲.md 不是两份稿件，是一份内容的两个视图：

于是有三条硬规矩：

1. 改内容只改 JSON，然后重跑 build 看审计，再同步 md——反过来（只改 md）会在下次渲染时静默丢失；
2. 改结构（加/删/换页）只改 JSON，md 整段重写，不要在两处各改一半；
3. 交付前必须核一遍两边页序与标题，这是唯一能发现漂移的办法（比对 md 里的「页面标题」字段）：

python3 - <<'PY'
import json, re
d = json.load(open("outline.json", encoding="utf-8"))
md = open([f for f in __import__("glob").glob("*-大纲.md")][0], encoding="utf-8").read()
sl = d["slides"]
content = re.findall(r"^- \*\*页面标题\*\*：(.+?)（一级）\s*(.+?)（重点句）$", md, re.M)
mains = re.findall(r"^- \*\*主标题\*\*：(.+)$", md, re.M)
print(f"JSON {len(sl)} 页 ｜ 大纲：封面封底主标题 {len(mains)}、内容页 {len(content)}")
bad = []
if len(mains) == 2:
    if sl[0]["title"] != mains[0].strip():
        bad.append(f"P1「{mains[0].strip()}」")
    if sl[-1]["title"] != mains[1].strip():
        bad.append(f"P{len(sl)}「{mains[1].strip()}」")
for i, (dim, title) in enumerate(content, 2):
    if sl[i - 1].get("dim") != dim.strip():
        bad.append(f"P{i} 维度「{dim.strip()}」")
    if sl[i - 1]["title"] != title.strip():
        bad.append(f"P{i} 标题「{title.strip()}」")
print("全部对齐" if not bad else "需修：" + "；".join(bad))
PY

它一次核三件事：封面与封底的主标题是否等于 JSON 首末页的 title、内容页「（一级）」的维度是否等于 dim、「（重点句）」是否等于 title。预期输出「全部对齐」；若有差异，说明某页改过但只改了一边，同样要修。真正抓不到的是"只改了详细内容里的措辞"，那种只能靠规矩：改内容一律先改 JSON。

3.2 写大纲时守住五条

1. 一页一个论点：标题写论点（"我原本不该选这条路"），不写栏目名（"自我认知"）。
2. 数字要有口径：每个数字能在追问时说出"谁统计、什么范围、什么时候"。
3. 证据位写死：这一页放哪份证书、哪张照片、哪条数据，没有就写"待补"并进 gaps。
4. 维度要有落点：给每页标 dim，成长用「职业目标 / 学习实践行动 / 优化改进」，就业用「职业目标 / 岗位胜任力 / 发展潜力」。三页全标同一个维度，说明结构偏了。
5. 每页能独立读懂：标题是论点，正文有 2–6 条可读信息，关键数字用小字 note 标口径。

3.3 阅读型的三个具体动作

• 加小字：bullets 每条可带 note（时间/出处/口径），timeline 每个节点可带 detail，kpi 每张卡可带 note；
• 一页装两个层次：论点在上，证据/说明在下（detail、cards、twocol 都是为这个设计的）；
• 别怕满，怕乱：每页 90–320 字是舒适区，超过 520 字审计会提示拆页。

3.4 顶层四件事必填

group（Z1–Z5）、group_label（页脚文字）、theme（主题）、gaps（缺口数组）。gaps 里把缺的素材写成句子（"缺企业实习证明""缺岗位招聘公告截图"），会进审计报告，也是答辩前要补的清单。

人读版按三部分写，字段固定：

封面与封底的主标题不带层级标注（它们不属于任何评分维度）；内容页的页面标题按两层写（见下）。

### P3 三个劝退我的理由 · bullets

- **页面标题**：职业目标（一级） 三个劝退我的理由（重点句）
- **核心观点**：我一开始的退缩来自不了解，不是来自判断——所以还能改。
- **详细内容**：
  1. 学院的专业预警名单里有它，我看过那张表（2025.09）。
  2. 行业出清的说法传了两届，没人给出处。
  3. 家里希望我考公，稳定、能回家。
- **证据**：教育部就业质量报告（P12）、2024 校招公告（P3）。

> 追问：第②条的数据哪来的？→ 备好口径，说不清就删掉这条。

页面标题按两层写：维度（一级） 论点句（重点句）。括号是层级标注，供排结构、核维度用，不进页面——页面上只渲染论点句本身（即 JSON 的 title）。页头因此不再重复 · 维度：xxx。

四项里只有两项上版面：

页脚的「追问」同样不上版面，供押题用。本文档不写口播逐字稿与秒数——口播内容放在 outline.json 的 notes 里，渲染时进 pptx 备注栏。

四项各自的写法：

4 卡点：一次问清三件事

不要分三次问，用户会被打断到烦。把三件事放进一次提问：

> 模板句：「这 18 页的顺序和每页论点你认可吗？主题我建议 tech（工科气质），如果学校有规定模板请发我。确认后我再出 PPTX。」

用户说"你先出个版本我看看"可以出，但要提前说明"版面按大纲锁定，改结构需要重跑"。

主题按岗位气质选，别按喜好选：

5 自检：先审后渲（必做，不能跳）

渲染之前先跑一次纯审计。这一步三十秒，能挡掉大部分返工：

python3 scripts/build_pptx.py outline.json --audit-only

读 -audit.md，按这张表逐条处理：

只要还有 E 级错误或紧度 >100%，不许进 Step 6。 带着溢出渲染，只会在 Step 7 被同一个问题挡回来，而那时候修的是字号和版面，比改文案贵得多。

6 渲染成 PPTX

# 标准（默认中文字体：微软雅黑，Windows 放映最稳）
python3 scripts/build_pptx.py outline.json -o "张三-成长赛道展示.pptx" --pdf

# 用学校模板（只借母版/背景/主题，占位符会清掉）
python3 scripts/build_pptx.py outline.json -o out.pptx --template 学校模板.pptx --pdf

# 这台机器只用来预览、想更好看时换本机字体
python3 scripts/build_pptx.py outline.json -o out.pptx --font "PingFang SC"

关于 PDF：--pdf 调用本机 LibreOffice。如果本机没装 pptx 里写的字体（默认微软雅黑），脚本会自动挑一个本机有的中文字体重建预览件再转 PDF——但预览件的字体仍不是最终字体，只用来查版式和页数；要直接交 PDF，就在装有目标字体的机器上导出。

7 复检：渲染级 + 文件级

估算用的是"字宽≈字号"的近似，字体替换、数字混排会偏乐观。两项都要过：

# 渲染级：越界 / 压字 / 过小字号
python3 scripts/verify_pptx.py "张三-成长赛道展示.pptx" --expect-pages 18

# 文件级：页数 / 尺寸 / 每页是否有备注
python3 scripts/check_deck.py "张三-成长赛道展示.pptx" --expect 18

verify_pptx.py 查三件事：越界（文字压到页边 20pt 以内）、压字（两个词框交叠 >26% 且两个方向都 >3.5pt）、过小字号（渲染高度 <9pt）。输出逐页表，有问题会指出第几页的哪两个词。

两个工具的关系：build_pptx.py 的审计防"写的时候就超载"，verify_pptx.py 防"算对了但渲染出来不对"。两个都过，才算这版能交。

改完重跑，最多两轮；两轮还不干净，通常是论点太多，回到 Step 3 砍页，而不是继续调脚本。

8 交付清单（缺一项都不算交付完）

按这个顺序说，不要只说"做好了"：

1. .pptx（可编辑）+ .pdf（预览/投屏备份）；
2. 大纲 md（含每页口播要点，可直接拿去写逐字稿）；
3. 审计 md（build 估算审计 + verify 渲染复核，明确是"全过"还是"仍有 WARN"）；
4. 素材缺口逐条（来自 gaps）——这是答辩前要补的清单，不能只给个数量；
5. 示例口径标注：哪些数字是占位、替换后要重跑；
6. 一句提醒：封面 meta、页脚组别、证书照片的打码是提交前必查项；
7. 若用了 --pdf：说明 PDF 是预览件，最终外观请在装有目标字体的机器上用 PowerPoint 确认。

9 页型速查

三个版式陷阱（实测踩过，写大纲时就避开）：

• twocol 的栏高是固定的，4 条单行要点只占一半、下方必留四成空白，加字也填不满（单条上限 30 字≈一行）→ 换 table（信息更硬）或 bullets（带小字）。
• compare 中间有橙色 VS 圆标，只适合真正对立的两栏（招聘要求 vs 现状）；并列关系用它会出现不合语义的 VS → 换 bullets。
• cards 三卡会被撑到全高、文字只占三成，明显空 → 补成四卡（宁可加一个反向人物），别留空壳。

10 红线

1. 不虚构：不编实习单位、不编证书、不编数据、不拿网图当现场照。素材缺就写"待补"，进 gaps。
2. 职规赛特有的不能写：就业赛道的"发展潜力"页不谈考研、出国、考公上岸；备选路径必须是同领域的相邻岗位，不能写"考公兜底"；成长赛道不把"保研"当阶段性目标。这三条是评委最容易当场判定"目标不真"的地方。
3. 口径不写旧版：成长 25/50/25、就业 10/40/40/10；不写第三届的成长 30/50/20 与就业 10/80/10；不提已取消的课程教学赛道。
4. 不越界：不代写生涯发展报告/简历正文，只做展示页。
5. 不承诺结果：不说"这样排版就能获奖"；审计报告只说结构与版面事实。
6. 隐私：他人正脸、患者、未成年人、涉密设备一律打码或换图，标注"已获授权"；单位名可脱敏为"某电池厂""某三甲医院"；学号、身份证号、家庭收入、父母职业不上版，家庭约束只写"家里对驻外有保留"这类可公开表述。
7. 模板版权：用户自带模板时只借用其母版与主题，不复制他人设计稿内容。
8. 图片纪律：证书/合同/工单用 contain 不裁切；缺图画灰位 [待配图]；不把本地图片路径写进 pptx 正文；不用 AI 生成图冒充实拍证据。

11 失败时怎么办

脚本报错、[FAIL]、主题 id 不存在、模板路径不对时：把脚本原句告诉用户，停在那一步。

• 不要手改 pptx 绕过 JSON——下次重跑就丢；
• 不要把 Python 堆栈收成"生成失败"四个字——用户没法据此行动；
• 不要为了跑通而删检查（比如跳过 verify）——检查是这技能的价值所在；
• 依赖缺失就照 §12 给命令，不改用网页工具或在线转换补齐。

12 环境依赖

本技能不带 requirements.txt，按上表逐项装即可。

用哪个解释器：脚本需要 python-pptx，务必用装了它的解释器跑（本机为 ~/.workbuddy/binaries/python/envs/default/bin/python）。managed python 常缺这个包，会 ModuleNotFoundError。

13 与其他技能的分工

推荐顺序：陈述稿定调 → 本技能出页 → 逐页口播要点回填陈述稿 → zgs-qa 押题 → zgs-review 打分。反过来（先做 PPT 再配词）最容易出现"页很满、话很空"。

14 失败模式与对策