Skill 从入门到精通——第四章 Anthropic 官方Skill解析—pptx Skill 解析

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

pptx/
├── SKILL.md                    # 编排层：触发条件、设计规范、QA 强制要求
├── editing.md                  # 模板编辑模式完整指南（工作流程SOP + 格式化规则 + 常见陷阱）
├── pptxgenjs.md                # PptxGenJS 从零创建指南（API 参考 + 常见陷阱）
├── LICENSE.txt                 # 专有协议
└── scripts/                    # 执行层
    ├── add_slide.py            # 幻灯片克隆 / 从布局创建新幻灯片
    ├── clean.py                # 文件清理（引用图遍历算法）
    ├── thumbnail.py            # 缩略图网格生成（soffice → PDF → ppm）
    └── office/                 # Office 通用基础设施（与 docx/xlsx 技能共享）
        ├── unpack.py           # 解压 + XML 美化 + 智能引号转义 + DOCX 预处理
        ├── pack.py             # XML 压缩 + 验证编排 + ZIP 回包
        ├── soffice.py          # LibreOffice 沙箱适配层（运行时 LD_PRELOAD shim 编译）
        ├── validate.py         # 验证路由 CLI 入口
        ├── helpers/            # DOCX 专用 DOM 优化器
        ├── validators/         # OOXML Schema 验证体系
        └── schemas/            # 内嵌 XSD Schema 库（离线，零外部依赖）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

            
用户请求涉及 .pptx
│
├─ 读取/分析内容？
│  ├─ 纯文本提取    → python -m markitdown presentation.pptx
│  └─ 视觉概览      → python scripts/thumbnail.py presentation.pptx
│
├─ 编辑/修改现有 PPTX？
│  ├─ 有模板/参考文件  → 模板编辑模式（读取 editing.md 工作流）
│  │                      unpack → analyze → manipulate → edit → clean → pack → QA
│  └─ 无模板           → 不适用（建议先获取模板或转从零创建新 PPTX）
│
├─ 从零创建新 PPTX？
│  └─ 无模板可用       → PptxGenJS 模式（读取pptxgenjs.md）
│                      (pptxgenjs + 设计规范 + QA 流程)
│
└─ 需要视觉 QA？
   └─ 生成图片检查     → soffice.py --convert-to pdf → pdftoppm -jpeg

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# Step 1: 分析模板
   ├── python scripts/thumbnail.py template.pptx          # 视觉概览
   └── python -m markitdown template.pptx                 # 文本内容概览

# Step 2: 规划幻灯片映射（内容 → 布局匹配）
# 原则：拒绝单调布局，主动选择多列、图文组合、全出血图、引用页、数据看板等
   ├── 为每个内容段选择合适的布局（必须多样化：多列、图文、引言、数据卡等）
   └── 避免：所有幻灯片使用同一布局

# Step 3: 解包
   └── python scripts/office/unpack.py template.pptx unpacked/   # 解包

# Step 4: 结构操作（由主 Agent 执行，非子代理）
   ├── 删除幻灯片：从 presentation.xml 的 p:sldIdLst 移除对应 p:sldId
   ├── 复制幻灯片：python scripts/add_slide.py unpacked/ slide2.xml
   ├── 调整顺序：重排 p:sldIdLst 中的元素
   └── 完成所有结构变更后再进入内容编辑

# Step 5: 内容编辑（可使用子代理并行，每页独立 XML）
   ├── 每个 slide{N}.xml 是独立文件，Subagent 可并行编辑
   ├── 必须：使用 Edit 工具（禁止 sed / Python 脚本直接修改）
   ├── 必须：标题/标头使用 b="1"
   ├── 禁止：Unicode  bullets（•），使用 <a:buChar> 或 <a:buAutoNum>
   └── 多个项目必须拆分为独立 <a:p> 元素

# Step 6: 清理
   └── python scripts/clean.py unpacked/                  

# Step 7: 打包&验证
   └── python scripts/office/pack.py unpacked/ output.pptx --original template.pptx
       # 内部执行：condense XML → XSD 差分验证 → auto-repair → ZIP 打包

# QA（强制）
   ├── 内容 QA：python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum"
   ├── 视觉 QA：soffice.py --convert-to pdf → pdftoppm -jpeg → Subagent 图像审查
   └── 修复 → 重新验证 → 直到一次完整检查无新问题

1
2
3
4
5
6

npm install -g pptxgenjs react-icons react react-dom sharp

Node.js 脚本 → pres.addSlide() / addText() / addImage() / addChart() / addTable()
→ pres.writeFile({ fileName: "Presentation.pptx" })

QA 同模板模式（转为 PDF → 图像检查）

1
2
3
4
5
6
7

调用 pptx 技能，基于以下主题生成一份基础的演示文稿：
主题：2024 年第一季度产品销售复盘
要求：
1. 包含封面、目录、销售数据概览、区域销售分析、问题与改进建议、总结 6 个页面；
2. 配色以商务蓝为主，字体统一使用微软雅黑；
3. 销售数据概览页需插入柱状图展示各产品线销售额；
4. 输出格式为 pptx 文件，文件命名为 “2024Q1 销售复盘.pptx”。

1
2
3
4
5

调用 pptx 技能，对已生成的 “2024Q1 销售复盘.pptx” 进行如下修改：
1. 将 “区域销售分析” 页的图表替换为饼图（展示各区域销售额占比）；
2. 在 “问题与改进建议” 页末尾新增 “行动项时间节点” 表格，包含行动项、负责人、完成时间 3 列；
3. 调整封面页标题字体大小为 36 号，副标题为 24 号；
4. 保存修改后的文件，命名为 “2024Q1 销售复盘_修订版.pptx”。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

调用 pptx 技能，制作一份关联 Excel 数据的销售分析 PPT：
数据源：“2024 月度销售数据.xlsx”（包含月份、销售额、客单价、复购率字段）
要求：
1. 自动从 Excel 中提取数据，生成 3 个可视化图表：
   - 月度销售额趋势折线图；
   - 客单价 vs 复购率散点图；
   - 各季度销售额占比环形图；
2. 图表需关联数据源，当 Excel 数据更新时，PPT 图表可一键刷新；
3. 每个图表页添加数据解读文字（简要分析趋势 / 异常点）；
4. PPT 中添加数据筛选按钮，可切换展示 “华东 / 华南 / 华北” 区域数据；
5. 输出 pptx 文件，并附带数据源关联操作说明。