agf-writing-pptx-reports

# 写 pptx 报告 — 高密度实战手册 > 沉淀自《AI 4A 架构评审管理办法》v1.0 PPT 实战（23 页，GAC 红主调，含双视图嵌入流程图），全部踩过 + 验证过的坑与方法。重型参考材料在 `references/`，按下方索引**按需 Read 全文**，不要凭记忆写代码。 ## 何时用本 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` ## References 索引（什么时候必读哪份） | 场景 | 必读（Read 全文） | |---|---| | 走"基于模板 + python-pptx 混合"路径（动手前） | [`references/template-based-generation.md`](./references/template-based-generation.md)（7 步流程 / 模板分析三件套 / Placeholder vs Shape / 关键文件指针）+ 对应 `template-*-guide.md`（如 [`template-team-guide.md`](./template-team-guide.md)）| | 写 helper / ...