Ppt Generator

PPT Generator Skill

专注于 PPT 生成的完整解决方案。

⚠️ 路径解析（每次执行前必须先运行）

此 skill 支持项目级安装（<project>/.claude/skills/）和全局安装（~/.claude/skills/）。执行任何命令前，先确定 SKILLS_DIR：

bashCopy code
SKILLS_DIR=$(python3 -c "
from pathlib import Path
cwd = Path.cwd()
for p in [cwd, *cwd.parents]:
    s = p / '.claude/skills'
    if (s / 'ppt-generator').exists():
        print(s); exit()
print(Path.home() / '.claude/skills')
")

后续所有命令均使用 $SKILLS_DIR 替代 ~/.claude/skills。

触发条件

当用户请求涉及以下内容时激活：

• 生成 PPT / 幻灯片 / 演示文稿
• 制作 PPT / 做 PPT
• 大纲转 PPT
• PPT 风格选择
• 修改 PPT 某一页

风格选择指南（22 种风格）

当用户提出 PPT 需求时，你（Claude）根据以下指南选择风格，不要调用任何 Python 推荐函数。

分析维度

1. 场景: tech / business / education / creative / lifestyle / academic / gaming / historical
2. 受众: beginners / general / experts / executives / children
3. 调性: formal / casual / playful / serious / warm / professional

风格评分表

第一梯队：通用高质量风格（质量分 9-10）

第二梯队：专业领域风格（质量分 8）

第三梯队：教育风格（质量分 7-8）

第四梯队：创意风格（质量分 7-8）

第五梯队：特色风格（质量分 6-7）

快速选择指南

按场景选择

按受众选择

按调性选择

主题色选择（仅 apple 风格）

可用布局

工作流

流程 1：生成 PPT

1. 分析用户需求 - 识别场景、受众、调性
2. 选择风格 - 根据上述评分表选择最合适的风格
3. 告知用户 - 说明选择的风格和原因
4. 创建输出目录 - ~/ppt-output/{项目名}/
5. 生成幻灯片 - 调用 Python 执行层

pythonCopy code
import sys, os
from pathlib import Path
sys.path.insert(0, str(Path(os.environ.get('SKILLS_DIR', str(Path.home() / '.claude/skills'))) / 'shared-lib'))

from presentation import create_session, PresentationGenerator

# 1. 创建 session
session = create_session(
    title='项目标题',
    style='vintage',  # 你选择的风格
    language='zh',
    audience='general'
)

# 2. 创建输出目录
output_dir = session.create_output_directory('项目标题')

# 3. 生成幻灯片
gen = PresentationGenerator(style='vintage')
gen.generate_slide(
    layout='cover',
    content='标题\n副标题',
    output_path=str(output_dir / 'slide_01.png')
)

流程 2：批量生成

pythonCopy code
# 批量生成多页
results = gen.batch_generate_slides(
    slides_config=[
        {'layout': 'cover', 'content': '标题'},
        {'layout': 'content_left', 'content': '要点列表'},
    ],
    output_dir=str(output_dir)
)

流程 3：导出 PPTX

bashCopy code
python "$SKILLS_DIR/ppt-generator/scripts/assemble_pptx.py" \
    --input_dir ~/ppt-output/项目名/ \
    --output ~/ppt-output/项目名/presentation.pptx

输出目录结构

Copy code
~/ppt-output/{项目名}/
├── prompts/
│   ├── 01-slide-封面.md
│   ├── 02-slide-xxx.md
│   └── ...
├── slide_01.png
├── slide_02.png
├── slide_03.png
├── ppt_content.yaml
├── presentation.pptx
└── presentation.pdf

配置依赖

图片生成依赖 $SKILLS_DIR/shared-lib/config.yaml，包含：

注意事项

1. 风格选择由 AI 完成 - 根据本文档的评分表判断，不调用 Python 推荐函数
2. 质量优先 - 多个风格匹配度接近时，选择质量分更高的
3. 受众优先 - 儿童/初学者 → 友好风格；高管 → 简洁风格
4. 稳定性考虑 - 重要场合选择稳定性高的风格（apple, corporate, minimal）
5. 风格一致 - 一个 PPT 只用一种风格，不要混用