【学习笔记】GordenPPTSkill 项目深度解析：Claude Code 的 PPT 自动化 Skill

GordenPPTSkill/
├── SKILL.md                    # Skill 定义文件
├── README.md                   # 项目说明
├── templates/
│   ├── INDEX.md               # 模板索引
│   ├── minimal-business-summary/    # 极简商务总结模板
│   ├── modern-tech-pitch/           # 现代科技提案模板
│   └── ... (共19套模板)
├── references/
│   ├── custom-template-workflow.md  # 自定义模板工作流
│   ├── original-design-guide.md     # 设计规范
│   └── pptx-edit-schema.md          # 编辑模式文档
└── tools/
    ├── build_pptx.py          # 核心构建脚本
    └── compute_capacity.py    # 容量计算工具

人类设计模板（排版） → AI 填充内容（文字）

# compute_capacity.py 计算逻辑
capacity = {
    "chars_per_line": 20,    # 每行字符数
    "max_lines": 3,          # 最大行数
    "max_chars": 60          # 最大字符数
}

# 主要功能
1. 读取 template.pptx（模板）
2. 读取 detail.json（结构描述）
3. 读取 edits.json（编辑指令）
4. 执行编辑操作
5. 输出最终 PPTX

# 主要功能
1. 分析文本框尺寸
2. 计算字体大小
3. 估算可容纳字数
4. 生成容量报告

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  template   │    │   detail    │    │    edits    │
│   .pptx     │ +  │   .json     │ +  │   .json     │
│  (视觉设计)  │    │  (结构描述)  │    │  (编辑指令)  │
└──────┬──────┘    └──────┬──────┘    └──────┬──────┘
       │                  │                  │
       └──────────────────┼──────────────────┘
                          ▼
                   ┌─────────────┐
                   │ build_pptx  │
                   │    .py      │
                   └──────┬──────┘
                          ▼
                   ┌─────────────┐
                   │  output     │
                   │   .pptx     │
                   └─────────────┘

minimal-business-summary/
├── template.pptx           # 模板文件
├── detail.json            # 结构描述
├── preview.png            # 预览图
└── README.md              # 模板说明

{
  "template_name": "minimal-business-summary",
  "slides": [
    {
      "slide_number": 1,
      "layout": "title_slide",
      "slots": [
        {
          "slot_id": "title",
          "type": "text",
          "max_chars": 60,
          "level": 1
        },
        {
          "slot_id": "subtitle",
          "type": "text",
          "max_chars": 120,
          "level": 2
        }
      ]
    }
  ],
  "type_scale": {
    "level_1": 44,
    "level_2": 32,
    "level_3": 24
  }
}

{
  "type_scale": {
    "level_1": 44,   // 主标题
    "level_2": 32,   // 副标题
    "level_3": 24,   // 小标题
    "level_4": 18    // 正文
  }
}

┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│  Step 1  │ → │  Step 2  │ → │  Step 3  │ → │  Step 4  │ → │  Step 5  │
│ 设计PPT  │   │ 标记slot │   │ 生成JSON │   │ 计算容量 │   │ 生成预览 │
└──────────┘   └──────────┘   └──────────┘   └──────────┘   └──────────┘

{
  "template_name": "my-template",
  "slides": [
    {
      "slide_number": 1,
      "slots": [
        {
          "slot_id": "title",
          "type": "text",
          "level": 1
        }
      ]
    }
  ],
  "type_scale": {
    "level_1": 44,
    "level_2": 32
  }
}

python tools/compute_capacity.py \
  --template templates/my-template/template.pptx \
  --detail templates/my-template/detail.json \
  --output templates/my-template/detail.json

{
  "slides": [
    {
      "slide_number": 1,
      "layout": "title",
      "slots": [
        {
          "slot_id": "title",
          "type": "text",
          "max_chars": 40,
          "level": 1
        },
        {
          "slot_id": "subtitle",
          "type": "text",
          "max_chars": 80,
          "level": 2
        }
      ]
    },
    {
      "slide_number": 2,
      "layout": "content",
      "slots": [
        {
          "slot_id": "heading",
          "type": "text",
          "max_chars": 30,
          "level": 2
        },
        {
          "slot_id": "bullet_1",
          "type": "text",
          "max_chars": 100,
          "level": 3
        },
        {
          "slot_id": "bullet_2",
          "type": "text",
          "max_chars": 100,
          "level": 3
        }
      ]
    }
  ]
}

{
  "edits": [
    {
      "slide_number": 1,
      "slot_id": "title",
      "action": "replace",
      "content": "Q4 销售总结报告"
    },
    {
      "slide_number": 1,
      "slot_id": "subtitle",
      "action": "replace",
      "content": "2024年第四季度业绩回顾"
    }
  ]
}

{
  "metadata": {
    "template": "minimal-business-summary",
    "created_at": "2024-01-15",
    "version": "1.0"
  },
  "edits": [
    {
      "slide_number": 1,
      "slot_id": "title",
      "action": "replace",
      "content": "标题文字",
      "preserve_format": true
    },
    {
      "slide_number": 2,
      "slot_id": "chart_1",
      "action": "update_chart",
      "chart_data": {
        "categories": ["Q1", "Q2", "Q3", "Q4"],
        "values": [100, 150, 200, 250]
      }
    }
  ]
}

# 1. 选择模板
cd templates/minimal-business-summary

# 2. 查看模板详情
cat detail.json

# 3. 创建 edits.json
cat > edits.json << 'EOF'
{
  "edits": [
    {
      "slide_number": 1,
      "slot_id": "title",
      "action": "replace",
      "content": "产品发布计划"
    },
    {
      "slide_number": 1,
      "slot_id": "subtitle",
      "action": "replace",
      "content": "2025年新产品路线图"
    }
  ]
}
EOF

# 4. 构建 PPT
python ../../tools/build_pptx.py \
  --template template.pptx \
  --detail detail.json \
  --edits edits.json \
  --output output.pptx

# 5. 查看结果
open output.pptx

User: 帮我用 minimal-business-summary 模板生成一份季度总结PPT

Claude: 好的，我需要以下信息：
1. 季度（如：Q4 2024）
2. 主要业绩指标
3. 关键成果

User: Q4 2024，销售额增长30%，用户增长50%

Claude: [自动生成 edits.json 并调用 build_pptx.py]

新手 → 了解概念 → 使用现有模板 → 修改 edits.json
  ↓
进阶 → 理解 detail.json → 自定义模板 → 批量生成
  ↓
专家 → 开发新功能 → 贡献模板 → 集成到工作流