agfwriting-pptx-reportslisted

# 写 pptx 报告 — 高密度实战手册 > 沉淀自《AI 4A 架构评审管理办法》v1.0 PPT 实战（23 页，GAC 红主调，含双视图嵌入流程图） > 全部踩过 + 验证过的坑与方法，不含理论水文 ## 何时用本 skill | 信号 | 用本 skill | |---|:--:| | 需要程序化生成 PPT（数据驱动 / 模板批量 / 内容版本化） | ✅ | | 中文制度 / 党政 / 企业内部宣贯 deck | ✅ | | 用户反馈"老土 / 字体丑 / 表格乱 / 文字溢出 / 中文字体 fallback" | ✅ | | 内容会反复迭代，PPT 必须从源码可重生成 | ✅ | | 需要 mermaid 流程图嵌入 + 双视图卡片化 | ✅ | | 高度自由排版 / 视觉冲击型营销 deck | ❌ 直接 Keynote / Figma | | 复杂动画 / 视频嵌入 | ❌ python-pptx 弱项 | | 一次性单页海报 | ❌ 直接画 | | 要 docx / xlsx | ❌ 转 writing-docx-reports / xlsx skill | ## 路径决策（4 选 1） | 路径 | 何时选 | 代价 | |---|---|---| | **手动复制 .pptx 模板编辑** | 一次性 deck / 设计师介入 / 不需重生成 | 几分钟；后续维护成本高 | | **`pptx` skill 局部改** | 已有 .pptx 做小幅修改（≤ 5 张 slide / 仅换文字）| 中等；不适合从零生成 | | **基于模板 + `python-pptx` 混合** ⭐ | 仓库已有 .pptx 模板 / 视觉风格已定 / 需版本化 + 重生成 | 一次 ~500 行；保留模板视觉投入 + 代码可重跑 | | **`python-pptx` 全定制** | 没现成模板 / 视觉自己定义 / 跨平台中文 / 23+ 页量级 | 一次 ~800 行 Python，复用率 90% | 判定经验： - **本仓库 `template/` 已有 1 个 .pptx 模板**（`Template.pptx`，coral 团队风）→ 默认走"基于模板 + python-pptx 混合"，不要重造视觉 - **用户说"老土 / 中文字体不对 / 表格乱"** 基本意味着要"模板混合"或"全定制"——只有"手动复制"路径根治不了 - **用户给了具体模板路径**（如 "用 Template.pptx"）→ 必走"模板混合"路径，并先读对应的 `template-*-guide.md` ## ★ 基于已有 .pptx 模板生成（推荐路径详解） 适用：仓库 `template/` 下已有 `.pptx` 设计模板，用户希望保留模板视觉 + 程序化生成内容。 **前置必看**：每个已落地模板在本 skill 目录下都有一份 `template-*-guide.md`，例如 `template-team-guide.md`。**先读 guide 再动手**——它会告诉你该模板的可渲染 slide 范围、配色、字体覆盖坑、6 类页面用法、踩坑清单。 ### Step 1 — 模板分析三件套（先看再动） 依赖 `.claude/skills/pptx/`（Anthropic 提供的低层 .pptx 工具 skill）。 ```bash # 复制模板到临时目录 mkdir -p /tmp/template-analy