PPTX文档自动化技能：使用Python和Node.js编程创建编辑PowerPoint演示文稿

document-pptx by vasilyu1983/ai-agents-public

81 周安装量

49 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vasilyu1983/ai-agents-public --skill document-pptx

办公软件自动化文档生成

🇨🇳中文介绍

Document PPTX Skill - 快速参考

此技能支持以编程方式创建和编辑 PowerPoint 演示文稿。当用户需要生成推介演示文稿、报告、培训材料或自动化演示文稿工作流时，Claude 应应用这些模式。

现代最佳实践（2026年1月）：

一页幻灯片 = 一个要点；围绕一个决策或受众目标来设计演示文稿。
引用数字（定义 + 时间范围 + 来源）并为图表保持单一事实来源。
可访问性：幻灯片标题、阅读顺序、对比度以及有意义的替代文本；遵循您组织的标准（通常是 WCAG 2.2 AA / EN 301 549）。
对演示文稿进行版本控制并强制执行审查循环（避免使用 "final_final_v7.pptx"）。

快速参考

任务	工具/库	语言	使用场景
创建 PPTX	python-pptx	Python	演示文稿、幻灯片组
创建 PPTX	PptxGenJS	Node.js	服务器端生成
模板驱动	PPTX-Automizer	Node.js	企业品牌、模板注入
模板	python-pptx	Python	母版幻灯片、主题

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

创建演示文稿（Python）

from pptx import Presentation

prs = Presentation()

# 标题幻灯片
title_layout = prs.slide_layouts[0]  # Title Slide layout
slide = prs.slides.add_slide(title_layout)
title = slide.shapes.title
subtitle = slide.placeholders[1]
title.text = "Q4 2025 Business Review"
subtitle.text = "Presented by Product Team"

# 带项目符号的内容幻灯片
bullet_layout = prs.slide_layouts[1]  # Title and Content
slide = prs.slides.add_slide(bullet_layout)
slide.shapes.title.text = "Key Highlights"
body = slide.placeholders[1]
tf = body.text_frame
tf.text = "Revenue grew 25% YoY"

p = tf.add_paragraph()
p.text = "Customer base expanded to 10,000+"
p.level = 0

p = tf.add_paragraph()
p.text = "New enterprise tier launched"
p.level = 1  # Indented bullet

# 添加演讲者备注
notes_slide = slide.notes_slide
notes_slide.notes_text_frame.text = "Emphasize the enterprise growth story here."

prs.save('presentation.pptx')

创建演示文稿（Node.js）

import pptxgen from 'pptxgenjs';

async function main() {
  const pptx = new pptxgen();
  pptx.author = 'Product Team';
  pptx.title = 'Q4 Business Review';

  // 标题幻灯片
  let slide = pptx.addSlide();
  slide.addText('Q4 2025 Business Review', {
    x: 1, y: 2, w: '80%',
    fontSize: 36, bold: true, color: '363636',
    align: 'center',
  });
  slide.addText('Presented by Product Team', {
    x: 1, y: 3.5, w: '80%',
    fontSize: 18, color: '666666',
    align: 'center',
  });

  // 带项目符号的内容幻灯片
  slide = pptx.addSlide();
  slide.addText('Key Highlights', {
    x: 0.5, y: 0.5, w: '90%',
    fontSize: 28, bold: true,
  });
  slide.addText([
    { text: 'Revenue grew 25% YoY', options: { bullet: true } },
    { text: 'Customer base expanded to 10,000+', options: { bullet: true } },
    { text: 'New enterprise tier launched', options: { bullet: true, indentLevel: 1 } },
  ], { x: 0.5, y: 1.5, w: '90%', fontSize: 18 });

  // 添加图表
  slide = pptx.addSlide();
  slide.addChart(pptx.ChartType.bar, [
    { name: 'Sales', labels: ['Q1', 'Q2', 'Q3', 'Q4'], values: [100, 150, 180, 225] },
  ], { x: 1, y: 1.5, w: 8, h: 4 });

  await pptx.writeFile({ fileName: 'presentation.pptx' });
}

main();

添加图表（Python）

from pptx import Presentation
from pptx.util import Inches
from pptx.chart.data import CategoryChartData
from pptx.enum.chart import XL_CHART_TYPE

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])  # Blank

# Chart data
chart_data = CategoryChartData()
chart_data.categories = ['Q1', 'Q2', 'Q3', 'Q4']
chart_data.add_series('Revenue', (100, 150, 180, 225))
chart_data.add_series('Expenses', (80, 90, 100, 110))

# Add chart
x, y, cx, cy = Inches(1), Inches(1.5), Inches(8), Inches(5)
chart = slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED,
    x, y, cx, cy,
    chart_data
).chart

chart.has_legend = True
chart.legend.include_in_layout = False

prs.save('charts.pptx')

添加图像和表格

from pptx import Presentation
from pptx.util import Inches

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])  # Blank

# Add image
slide.shapes.add_picture('logo.png', Inches(0.5), Inches(0.5), width=Inches(2))

# Add table
rows, cols = 4, 3
table = slide.shapes.add_table(rows, cols, Inches(1), Inches(2), Inches(8), Inches(3)).table

# Set column headers
table.cell(0, 0).text = 'Product'
table.cell(0, 1).text = 'Sales'
table.cell(0, 2).text = 'Growth'

# Fill data
data = [
    ('Widget A', '$1.2M', '+25%'),
    ('Widget B', '$800K', '+15%'),
    ('Widget C', '$500K', '+40%'),
]
for row_idx, (product, sales, growth) in enumerate(data, 1):
    table.cell(row_idx, 0).text = product
    table.cell(row_idx, 1).text = sales
    table.cell(row_idx, 2).text = growth

prs.save('images_and_tables.pptx')

from pptx import Presentation

prs = Presentation('existing.pptx')

for slide_num, slide in enumerate(prs.slides, 1):
    print(f"\n--- Slide {slide_num} ---")
    for shape in slide.shapes:
        if shape.has_text_frame:
            for paragraph in shape.text_frame.paragraphs:
                print(paragraph.text)
        if shape.has_table:
            table = shape.table
            for row in table.rows:
                row_text = [cell.text for cell in row.cells]
                print(row_text)

幻灯片版式参考

版式索引	名称	使用场景
0	标题幻灯片	开场、章节分隔
1	标题和内容	标准项目符号幻灯片
2	节标题	章节过渡
3	两栏内容	并排比较
4	比较	优点/缺点、之前/之后
5	仅标题	自定义内容布局
6	空白	完全创意控制
7	带标题的内容	图像 + 描述

演示文稿结构模式

推介演示文稿（10页幻灯片）

PITCH DECK STRUCTURE
1. Title (company, tagline)
2. Problem (pain point)
3. Solution (your product)
4. Market Size (TAM/SAM/SOM)
5. Business Model (how you make money)
6. Traction (metrics, growth)
7. Team (founders, advisors)
8. Competition (landscape)
9. Financials (projections)
10. Ask (funding, next steps)

季度回顾（8页幻灯片）

QUARTERLY REVIEW STRUCTURE
1. Title + Agenda
2. Executive Summary (KPIs dashboard)
3. Revenue & Growth
4. Product Updates
5. Customer Highlights
6. Challenges & Learnings
7. Next Quarter Goals
8. Q&A

应做 / 避免（2025年12月）

使用幻灯片叙述计划（标题 + 一句话要点 + 支持性视觉元素）。
对于决策型演示文稿，将执行摘要放在前面。
保持演讲者备注与幻灯片要点一致。

包含多个信息的密集幻灯片。
未引用的数字或没有定义的图表。
像素化的截图和难以阅读的表格。

叙述性：每张幻灯片有一个一句话要点，并支持一个单一的决策或见解。
结构：开头的执行摘要 + 清晰的脉络（问题 -> 见解 -> 建议 -> 后续步骤）。
数据卫生：图表显示单位、时间范围、来源和一致的坐标轴。
设计：一致的排版、间距和对比度；没有"文字墙"幻灯片。
可访问性：设置阅读顺序并在需要的地方提供有意义的替代文本。

可选：AI / 自动化

仅在明确要求且符合政策时使用。

起草幻灯片标题和演讲者备注；人工验证准确性和语气。
根据数据生成图表代码；人工验证标签、单位和来源。

references/pptx-layouts.md - 母版幻灯片、主题、模板
references/pptx-charts.md - 图表类型、数据可视化
references/pptx-animations-transitions.md - 幻灯片切换、构建动画、计时
references/pptx-speaker-notes-delivery.md - 演讲者备注、演示者模式、交付准备
references/pptx-template-branding.md - 企业模板、多品牌支持
data/sources.json - 库文档链接

assets/pitch-deck.md - 初创公司推介结构
assets/quarterly-review.md - 业务回顾模板
assets/slide-narrative-template.md - 每张幻灯片一句话要点

../document-pdf/SKILL.md - 将演示文稿导出为 PDF
../document-xlsx/SKILL.md - 图表的数据源
../product-management/SKILL.md - 产品战略演示文稿

在最终回答之前，使用网络搜索/网页抓取来验证当前的外部事实、版本、定价、截止日期、法规或平台行为。
优先使用一手来源；对于易变信息，报告来源链接和日期。
如果无法访问网络，请说明限制并将指导标记为未经验证。

🇺🇸English

Document PPTX Skill - Quick Reference

This skill enables creation and editing of PowerPoint presentations programmatically. Claude should apply these patterns when users need to generate pitch decks, reports, training materials, or automate presentation workflows.

Modern Best Practices (Jan 2026) :

One slide = one takeaway; design the deck around a decision or audience goal.
Cite numbers (definition + timeframe + source) and keep a single source of truth for charts.
Accessibility: slide titles, reading order, contrast, and meaningful alt text; follow your org's standard (often WCAG 2.2 AA / EN 301 549).
Version decks and enforce review loops (avoid "final_final_v7.pptx").

Quick Reference

Task	Tool/Library	Language	When to Use
Create PPTX	python-pptx	Python	Presentations, slide decks
Create PPTX	PptxGenJS	Node.js	Server-side generation
Template-driven	PPTX-Automizer	Node.js	Corporate branding, template injection
Templates	python-pptx	Python	Master slides, themes
Charts	python-pptx	Python	Data visualizations
Extract content	python-pptx	Python	Parse existing decks

Selection guide

Prefer PPTX-Automizer when you have a branded .pptx template and need to "inject data into slides".
Prefer python-pptx in Python-heavy pipelines (reporting, notebooks, ETL).
Prefer PptxGenJS in Node.js pipelines (server-side generation, web apps).

Core Operations

Create Presentation (Python)

from pptx import Presentation

prs = Presentation()

# Title slide
title_layout = prs.slide_layouts[0]  # Title Slide layout
slide = prs.slides.add_slide(title_layout)
title = slide.shapes.title
subtitle = slide.placeholders[1]
title.text = "Q4 2025 Business Review"
subtitle.text = "Presented by Product Team"

# Content slide with bullets
bullet_layout = prs.slide_layouts[1]  # Title and Content
slide = prs.slides.add_slide(bullet_layout)
slide.shapes.title.text = "Key Highlights"
body = slide.placeholders[1]
tf = body.text_frame
tf.text = "Revenue grew 25% YoY"

p = tf.add_paragraph()
p.text = "Customer base expanded to 10,000+"
p.level = 0

p = tf.add_paragraph()
p.text = "New enterprise tier launched"
p.level = 1  # Indented bullet

# Add speaker notes
notes_slide = slide.notes_slide
notes_slide.notes_text_frame.text = "Emphasize the enterprise growth story here."

prs.save('presentation.pptx')

Create Presentation (Node.js)

import pptxgen from 'pptxgenjs';

async function main() {
  const pptx = new pptxgen();
  pptx.author = 'Product Team';
  pptx.title = 'Q4 Business Review';

  // Title slide
  let slide = pptx.addSlide();
  slide.addText('Q4 2025 Business Review', {
    x: 1, y: 2, w: '80%',
    fontSize: 36, bold: true, color: '363636',
    align: 'center',
  });
  slide.addText('Presented by Product Team', {
    x: 1, y: 3.5, w: '80%',
    fontSize: 18, color: '666666',
    align: 'center',
  });

  // Content slide with bullets
  slide = pptx.addSlide();
  slide.addText('Key Highlights', {
    x: 0.5, y: 0.5, w: '90%',
    fontSize: 28, bold: true,
  });
  slide.addText([
    { text: 'Revenue grew 25% YoY', options: { bullet: true } },
    { text: 'Customer base expanded to 10,000+', options: { bullet: true } },
    { text: 'New enterprise tier launched', options: { bullet: true, indentLevel: 1 } },
  ], { x: 0.5, y: 1.5, w: '90%', fontSize: 18 });

  // Add chart
  slide = pptx.addSlide();
  slide.addChart(pptx.ChartType.bar, [
    { name: 'Sales', labels: ['Q1', 'Q2', 'Q3', 'Q4'], values: [100, 150, 180, 225] },
  ], { x: 1, y: 1.5, w: 8, h: 4 });

  await pptx.writeFile({ fileName: 'presentation.pptx' });
}

main();

Add Charts (Python)

from pptx import Presentation
from pptx.util import Inches
from pptx.chart.data import CategoryChartData
from pptx.enum.chart import XL_CHART_TYPE

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])  # Blank

# Chart data
chart_data = CategoryChartData()
chart_data.categories = ['Q1', 'Q2', 'Q3', 'Q4']
chart_data.add_series('Revenue', (100, 150, 180, 225))
chart_data.add_series('Expenses', (80, 90, 100, 110))

# Add chart
x, y, cx, cy = Inches(1), Inches(1.5), Inches(8), Inches(5)
chart = slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED,
    x, y, cx, cy,
    chart_data
).chart

chart.has_legend = True
chart.legend.include_in_layout = False

prs.save('charts.pptx')

Add Images and Tables

from pptx import Presentation
from pptx.util import Inches

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])  # Blank

# Add image
slide.shapes.add_picture('logo.png', Inches(0.5), Inches(0.5), width=Inches(2))

# Add table
rows, cols = 4, 3
table = slide.shapes.add_table(rows, cols, Inches(1), Inches(2), Inches(8), Inches(3)).table

# Set column headers
table.cell(0, 0).text = 'Product'
table.cell(0, 1).text = 'Sales'
table.cell(0, 2).text = 'Growth'

# Fill data
data = [
    ('Widget A', '$1.2M', '+25%'),
    ('Widget B', '$800K', '+15%'),
    ('Widget C', '$500K', '+40%'),
]
for row_idx, (product, sales, growth) in enumerate(data, 1):
    table.cell(row_idx, 0).text = product
    table.cell(row_idx, 1).text = sales
    table.cell(row_idx, 2).text = growth

prs.save('images_and_tables.pptx')

Extract Content

from pptx import Presentation

prs = Presentation('existing.pptx')

for slide_num, slide in enumerate(prs.slides, 1):
    print(f"\n--- Slide {slide_num} ---")
    for shape in slide.shapes:
        if shape.has_text_frame:
            for paragraph in shape.text_frame.paragraphs:
                print(paragraph.text)
        if shape.has_table:
            table = shape.table
            for row in table.rows:
                row_text = [cell.text for cell in row.cells]
                print(row_text)

Slide Layout Reference

Layout Index	Name	Use Case
0	Title Slide	Opening, section dividers
1	Title and Content	Standard bullet slides
2	Section Header	Section transitions
3	Two Content	Side-by-side comparison
4	Comparison	Pros/cons, before/after
5	Title Only	Custom content placement
6	Blank	Full creative control
7	Content with Caption	Image + description

Presentation Structure Patterns

Pitch Deck (10 slides)

PITCH DECK STRUCTURE
1. Title (company, tagline)
2. Problem (pain point)
3. Solution (your product)
4. Market Size (TAM/SAM/SOM)
5. Business Model (how you make money)
6. Traction (metrics, growth)
7. Team (founders, advisors)
8. Competition (landscape)
9. Financials (projections)
10. Ask (funding, next steps)

Quarterly Review (8 slides)

QUARTERLY REVIEW STRUCTURE
1. Title + Agenda
2. Executive Summary (KPIs dashboard)
3. Revenue & Growth
4. Product Updates
5. Customer Highlights
6. Challenges & Learnings
7. Next Quarter Goals
8. Q&A

Do / Avoid (Dec 2025)

Do

Use a slide narrative plan (title + 1-sentence takeaway + supporting visual).
Put the executive summary up front for decision decks.
Keep speaker notes aligned with slide takeaways.

Avoid

Dense slides with multiple messages.
Uncited numbers or charts without definitions.
Pixelated screenshots and unreadable tables.

What Good Looks Like

Narrative: each slide has a 1-sentence takeaway and supports a single decision or insight.
Structure: opening executive summary + clear arc (problem -> insight -> recommendation -> next steps).
Data hygiene: charts show units, timeframes, sources, and consistent axes.
Design: consistent typography, spacing, and contrast; no "wall of text" slides.
Accessibility: reading order set and meaningful alt text where needed.

Optional: AI / Automation

Use only when explicitly requested and policy-compliant.

Draft slide headlines and speaker notes; humans verify accuracy and tone.
Generate chart code from data; humans verify labels, units, and sources.

Navigation

Resources

references/pptx-layouts.md - Master slides, themes, templates
references/pptx-charts.md - Chart types, data visualization
references/pptx-animations-transitions.md - Slide transitions, build animations, timing
references/pptx-speaker-notes-delivery.md - Speaker notes, presenter mode, delivery prep
references/pptx-template-branding.md - Corporate templates, multi-brand support
data/sources.json - Library documentation links

Templates

assets/pitch-deck.md - Startup pitch structure
assets/quarterly-review.md - Business review template
assets/slide-narrative-template.md - 1-sentence takeaway per slide

Related Skills

../document-pdf/SKILL.md - Export presentations to PDF
../document-xlsx/SKILL.md - Data source for charts
../product-management/SKILL.md - Product strategy decks

Fact-Checking

Use web search/web fetch to verify current external facts, versions, pricing, deadlines, regulations, or platform behavior before final answers.
Prefer primary sources; report source links and dates for volatile information.
If web access is unavailable, state the limitation and mark guidance as unverified.

Weekly Installs

Repository

vasilyu1983/ai-…s-public

GitHub Stars

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli72

cursor72

opencode71

codex70

github-copilot67

cline66

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

44,900 周安装