/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

参数

参数 说明 默认值

--context , -c

上下文目录或文件 当前目录

--output , -o

输出 skeleton.yaml 路径 skeleton.yaml

--batch

批处理模式，从 brief 文件生成

--style

预设样式 corporate-light

--duration

目标时长（分钟） 30

--audience

受众类型 professionals

--verbose , -v

详细输出 false

工作流程

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 文件。

上下文扫描规则

文档权重

文件模式 权重 说明

_meta.yaml

最高 元数据定义

课程计划.md , README.md

高 总览文档

0*.md

中高 开场/结束模块

*.md

中 内容模块

-ds/.docx

中 调研结果

内容识别

模式 识别为

案例:

, ### Case:

案例

数字 + % , 倍 , 万 , 亿

数据点

"..."

引用

表格 对比/框架

研究需求推断

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

缺口类型 生成的研究需求

案例不足 type: case_study

数据过时 type: statistics

缺少权威引用 type: quote

趋势描述模糊 type: trend

文件结构

.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 的关系

Skill 关系

/ppt-enrich

下游：接收 skeleton，生成 slide-md

/ppt-render

下下游：接收 slide-md，生成 PPTX

/ppt

编排器：协调整个流程

版本历史

版本 日期 变更

1.0.0 2026-01-12 初版

相关文档

• skeleton-spec.md - Skeleton YAML 规范

• slide-md-spec.md - Slide Markdown 规范