ppt-outline（PPT 大纲）

/ppt-outline

从上下文生成 PPT 骨架结构（skeleton.yaml）

概述

/ppt-outline 是 PPT 生成流水线的入口，负责分析输入上下文（文档、对话、需求描述），通过对话式交互澄清需求，生成结构化的 PPT 骨架文件。它是一个结构生成器，不负责内容填充——只专注于定义"讲什么"和"怎么组织"。

定位

/ppt-outline → /ppt-enrich → /ppt-render
     ↑
 你在这里

用法

交互模式（推荐）

/ppt-outline                    # 交互式生成骨架
/ppt-outline --context ./docs/  # 指定上下文目录

批处理模式

/ppt-outline --batch brief.yaml -o skeleton.yaml

参数

工作流程

Step 1: 上下文扫描

自动扫描指定目录，识别：

• Markdown 文档 (.md)
• 元数据文件 (_meta.yaml)
• 已有骨架 (skeleton.yaml)
• 研究结果 (*-ds/ 目录)

Context Analysis:
  Documents: 6 files, 45,230 chars
  Modules: 4 detected
  Cases: 12 found
  Data points: 45 found

Step 2: 需求澄清（交互式）

通过对话澄清关键信息：

📋 PPT 骨架生成向导

Q1: 演示的主要目标是什么？
    [ ] 培训教学
    [ ] 项目汇报
    [x] 会议演讲
    [ ] 产品推介

Q2: 目标时长？
    → 90 分钟

Q3: 受众是谁？
    → 企业决策层（董事长/CEO）

Q4: 有哪些必须涵盖的主题？
    → AI趋势、行业案例、落地框架

Step 3: 骨架生成

基于上下文和需求，生成结构化骨架：

meta:
  title: "生成式AI驱动的产业应用与企业转型"
  version: "1.0"

audience:
  type: executives
  size: 30

presentation:
  duration: 90
  occasion: training
  style: corporate-light

structure:
  - id: "00-opening"
    title: "AI大势判断与破冰互动"
    type: opening
    duration: 12
    ...

Step 4: 研究需求标记

自动识别需要调研补充的内容：

research_needs:
  - type: case_study
    query: "制造业AI应用案例，要求有ROI数据"
    priority: high
    count: 3
  - type: statistics
    query: "2024-2025 AI市场规模数据"
    priority: medium

输入格式

上下文目录结构

docs/
├── _meta.yaml              # 元数据（可选）
├── 课程计划.md             # 总览文档
├── 01-模块一.md            # 内容文档
├── 02-模块二.md
└── 01-模块一-ds/           # 调研目录
    └── research.docx

Brief 文件（批处理模式）

# brief.yaml
title: "AI培训课程"
duration: 60
audience: managers
topics:
  - "AI基础概念"
  - "行业应用案例"
  - "实施路径"
style: corporate-light

输出格式

生成符合 skeleton-spec.md 规范的 YAML 文件。

上下文扫描规则

文档权重

内容识别

研究需求推断

根据内容缺口自动生成研究需求：

文件结构

.claude/skills/ppt-outline/
├── SKILL.md                    # 本文档
├── scripts/
│   ├── outline.py              # 主入口脚本
│   ├── context_scanner.py      # 上下文扫描器
│   ├── skeleton_generator.py   # 骨架生成器
│   └── research_extractor.py   # 研究需求提取器
└── templates/
    └── skeleton_template.yaml  # 骨架模板

依赖

• Python >= 3.9
• PyYAML
• python-docx（可选，用于读取.docx）

API（编程使用）

from outline import PPTOutline

outline = PPTOutline(
    context_dir='./docs/',
    style='corporate-light',
    duration=90
)

# 扫描上下文
context = outline.scan_context()

# 生成骨架
skeleton = outline.generate(
    title="AI培训课程",
    audience="executives"
)

# 保存
outline.save('skeleton.yaml')

与其他 Skill 的关系

版本历史

相关文档

• skeleton-spec.md - Skeleton YAML 规范
• slide-md-spec.md - Slide Markdown 规范