# PPTX

演示文稿创建、编辑和分析。当 Claude 需要处理演示文稿（.pptx 文件）时使用，包括：(1) 创建新演示文稿，(2) 修改或编辑内容，(3) 处理版式，(4)...

- Repository: https://github.com/LeastBit/Claude_skills_zh-CN (602 stars)
- Category: Documents
- License: 专有。LICENSE.txt 包含完整条款
- Last updated: 2026-01-19
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add LeastBit/Claude_skills_zh-CN --skill pptx -g -a claude-code -y`
Codex: `npx skills add LeastBit/Claude_skills_zh-CN --skill pptx -g -a codex -y`
Cursor: `npx skills add LeastBit/Claude_skills_zh-CN --skill pptx -g -a cursor -y`
Gemini CLI: `npx skills add LeastBit/Claude_skills_zh-CN --skill pptx -g -a gemini-cli -y`

## Description

演示文稿创建、编辑和分析。当 Claude 需要处理演示文稿（.pptx 文件）时使用，包括：(1) 创建新演示文稿，(2) 修改或编辑内容，(3) 处理版式，(4) 添加批注或演讲者备注，或其他任何演示文稿任务

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# PPTX 创建、编辑和分析

## 概述

用户可能会要求您创建、编辑或分析 .pptx 文件的内容。.pptx 文件本质上是一个包含 XML 文件和其他资源的 ZIP 压缩包，您可以读取或编辑。不同的任务有不同的工具和工作流程可用。

## 读取和分析内容

### 文本提取
如果您只需要读取演示文稿的文本内容，应将文档转换为 markdown：

```bash
# 将文档转换为 markdown
python -m markitdown path-to-file.pptx
```

### 原始 XML 访问
您需要原始 XML 访问来处理：批注、演讲者备注、幻灯片版式、动画、设计元素和复杂格式。对于这些功能，您需要解压演示文稿并读取其原始 XML 内容。

#### 解压文件
`python ooxml/scripts/unpack.py <office_file> <output_dir>`

**注意**：unpack.py 脚本位于相对于项目根目录的 `skills/pptx/ooxml/scripts/unpack.py`。如果脚本不在此路径，请使用 `find . -name "unpack.py"` 来定位它。

#### 关键文件结构
* `ppt/presentation.xml` - 主演示文稿元数据和幻灯片引用
* `ppt/slides/slide{N}.xml` - 单个幻灯片内容（slide1.xml、slide2.xml 等）
* `ppt/notesSlides/notesSlide{N}.xml` - 每个幻灯片的演讲者备注
* `ppt/comments/modernComment_*.xml` - 特定幻灯片的批注
* `ppt/slideLayouts/` - 幻灯片版式模板
* `ppt/slideMasters/` - 母版幻灯片模板
* `ppt/theme/` - 主题和样式信息
* `ppt/media/` - 图片和其他媒体文件

#### 排版和颜色提取
**当提供了要模仿的示例设计时**：始终先使用以下方法分析演示文稿的排版和颜色：
1. **读取主题文件**：检查 `ppt/theme/theme1.xml` 中的颜色（`<a:clrScheme>`）和字体（`<a:fontScheme>`）
2. **采样幻灯片内容**：检查 `ppt/slides/slide1.xml` 中的实际字体使用（`<a:rPr>`）和颜色
3. **搜索模式**：使用 grep 在所有 XML 文件中查找颜色（`<a:solidFill>`、`<a:srgbClr>`）和字体引用

## 创建新 PowerPoint 演示文稿 **不使用模板**

从头开始创建新 PowerPoint 演示文稿时，使用 **html2pptx** 工作流程将 HTML 幻灯片转换为具有精确定位的 PowerPoint。

### 设计原则

**关键**：在创建任何演示文稿之前，分析内容并选择适当的设计元素：
1. **考虑主题**：这个演示文稿是关于什么的？它暗示什么语气、行业或情绪？
2. **检查品牌**：如果用户提到公司/组织，考虑其品牌颜色和形象
3. **将调色板与内容匹配**：选择反映主题的颜色
4. **说明您的方法**：在编写代码之前解释您的设计选择

**要求**：
- ✅ 在编写代码之前说明您基于内容的设计方法
- ✅ 仅使用网页安全字体：Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact
- ✅ 通过大小、粗细和颜色创建清晰的视觉层次
- ✅ 确保可读性：强烈对比、适当大小的文本、整洁的对齐
- ✅ 保持一致性：在幻灯片之间重复模式、间距和视觉语言

#### 调色板选择

**创造性地选择颜色**：
- **跳出默认思维**：什么颜色真正匹配这个特定主题？避免自动选择。
- **考虑多个角度**：主题、行业、情绪、能量水平、目标受众、品牌形象（如有提及）
- **大胆尝试**：尝试意想不到的组合 - 医疗保健演示文稿不必是绿色的，金融不必是海军蓝
- **构建调色板**：选择 3-5 种配合良好的颜色（主色 + 辅助色 + 强调色）
- **确保对比**：文本必须在背景上清晰可读

**示例调色板**（用于激发创意 - 选择一个、调整它或创建自己的）：

The rest: https://github.com/LeastBit/Claude_skills_zh-CN/blob/HEAD/skills/pptx/SKILL.md
