feat: 新增 account 和 plan 目录
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
394
account/admin/skills/ppt-creator/SKILL.md
Normal file
394
account/admin/skills/ppt-creator/SKILL.md
Normal file
@@ -0,0 +1,394 @@
|
||||
---
|
||||
name: openakita/skills@ppt-creator
|
||||
description: Create professional presentations using the Pyramid Principle methodology. Supports PPTX generation, Marp/Reveal.js Markdown slides, chart creation, speaker notes, and self-evaluation rubrics. Minimal intake form to rapid output workflow.
|
||||
license: MIT
|
||||
metadata:
|
||||
author: openakita
|
||||
version: "1.0.0"
|
||||
---
|
||||
|
||||
# PPT Creator — 专业演示文稿制作
|
||||
|
||||
## When to Use
|
||||
|
||||
- 用户需要制作商业演示文稿（汇报、路演、培训、产品介绍）
|
||||
- 需要将非结构化的想法整理为逻辑清晰的幻灯片
|
||||
- 需要生成包含数据图表的演示文稿
|
||||
- 需要自动生成演讲稿/备注
|
||||
- 需要将 Markdown 转换为演示文稿格式（Marp / Reveal.js）
|
||||
- 需要评估已有 PPT 的质量
|
||||
|
||||
---
|
||||
|
||||
## Prerequisites
|
||||
|
||||
### 必需工具
|
||||
|
||||
| 工具 | 用途 | 安装方式 |
|
||||
|------|------|---------|
|
||||
| Python ≥ 3.10 | 运行生成脚本 | 系统预装 |
|
||||
| `python-pptx` | 生成 PPTX 文件 | `pip install python-pptx` |
|
||||
|
||||
### 可选工具
|
||||
|
||||
| 工具 | 用途 | 安装方式 |
|
||||
|------|------|---------|
|
||||
| `marp-cli` | Markdown → PPT/PDF | `npm install -g @marp-team/marp-cli` |
|
||||
| `matplotlib` | 数据图表生成 | `pip install matplotlib` |
|
||||
| `Pillow` | 图片处理 | `pip install Pillow` |
|
||||
| `plotly` | 交互式图表 | `pip install plotly kaleido` |
|
||||
|
||||
### 验证安装
|
||||
|
||||
```bash
|
||||
python -c "from pptx import Presentation; print('python-pptx OK')"
|
||||
marp --version # 可选
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Instructions
|
||||
|
||||
### 核心方法论：金字塔原理（Pyramid Principle）
|
||||
|
||||
本技能采用 Barbara Minto 的金字塔原理组织幻灯片结构：
|
||||
|
||||
```
|
||||
┌──────────────┐
|
||||
│ 核心结论 │ ← 1 句话概括
|
||||
└──────┬───────┘
|
||||
┌─────────┼─────────┐
|
||||
┌────┴────┐ ┌──┴───┐ ┌──┴────┐
|
||||
│ 论点 A │ │论点 B│ │论点 C │ ← 3 个支撑论点
|
||||
└────┬────┘ └──┬───┘ └──┬────┘
|
||||
证据1-3 证据1-3 证据1-3 ← 每个论点 2-3 条证据
|
||||
```
|
||||
|
||||
**原则：**
|
||||
1. **结论先行** — 每页幻灯片的标题就是该页的结论
|
||||
2. **以上统下** — 上层观点是下层内容的概括
|
||||
3. **归类分组** — 同层内容属于同一逻辑范畴
|
||||
4. **逻辑递进** — 同层内容有明确的排列顺序（时间、结构、重要性）
|
||||
|
||||
### 演示文稿结构模板
|
||||
|
||||
| 幻灯片 | 内容 | 时间 |
|
||||
|--------|------|------|
|
||||
| 封面 | 标题、副标题、演讲者、日期 | — |
|
||||
| 目录/议程 | 演讲结构概览 | 30s |
|
||||
| 背景/问题 | 现状描述、痛点阐述 | 45-60s |
|
||||
| 核心论点 1 | 第一个支撑论点 + 数据/案例 | 45-60s |
|
||||
| 核心论点 2 | 第二个支撑论点 + 数据/案例 | 45-60s |
|
||||
| 核心论点 3 | 第三个支撑论点 + 数据/案例 | 45-60s |
|
||||
| 方案/建议 | 具体行动方案 | 45-60s |
|
||||
| 时间线/路线图 | 实施计划 | 45-60s |
|
||||
| 总结 | 回扣核心结论、关键要点 | 30s |
|
||||
| Q&A / 致谢 | 联系方式、讨论时间 | — |
|
||||
|
||||
---
|
||||
|
||||
## Workflows
|
||||
|
||||
### Workflow 1: 快速创建（Minimal Intake Form）
|
||||
|
||||
**步骤 1 — 收集关键信息**
|
||||
|
||||
向用户询问以下 5 个要素（尽量精简）：
|
||||
|
||||
| # | 问题 | 示例回答 |
|
||||
|---|------|---------|
|
||||
| 1 | 演讲主题是什么？ | "Q4 产品路线图汇报" |
|
||||
| 2 | 目标受众是谁？ | "公司管理层" |
|
||||
| 3 | 核心结论/诉求？ | "需要追加 30% 研发预算" |
|
||||
| 4 | 有哪些关键数据或论据？ | "用户增长 200%、竞品分析、技术债" |
|
||||
| 5 | 幻灯片数量偏好？ | "10-15 页" |
|
||||
|
||||
如果用户只给了主题，根据常识和金字塔原理自行推导其余要素，并在生成前确认。
|
||||
|
||||
**步骤 2 — 构建金字塔结构**
|
||||
|
||||
基于收集的信息，输出结构大纲：
|
||||
|
||||
```
|
||||
核心结论：追加 30% 研发预算以支撑用户增长
|
||||
├── 论点A：用户量爆发增长（200%）带来系统压力
|
||||
│ ├── 证据：月活跃用户趋势图
|
||||
│ ├── 证据：服务器负载数据
|
||||
│ └── 证据：用户投诉工单增长
|
||||
├── 论点B：竞品正在加速投入
|
||||
│ ├── 证据：竞品融资/招聘动态
|
||||
│ ├── 证据：功能对比矩阵
|
||||
│ └── 证据：市场份额变化
|
||||
└── 论点C：技术债已影响迭代速度
|
||||
├── 证据：发布周期对比
|
||||
├── 证据：Bug 趋势
|
||||
└── 证据：开发者满意度调查
|
||||
```
|
||||
|
||||
**步骤 3 — 生成幻灯片内容**
|
||||
|
||||
逐页编写：
|
||||
- **标题**：一句完整的结论性陈述（非主题词）
|
||||
- **正文**：3-5 个要点，每点 ≤ 15 字
|
||||
- **图表/数据**：识别需要数据可视化的页面
|
||||
- **备注**：45-60 秒的演讲脚本
|
||||
|
||||
**步骤 4 — 输出文件**
|
||||
|
||||
根据用户需要选择输出格式（见 Output Format 部分）。
|
||||
|
||||
---
|
||||
|
||||
### Workflow 2: 数据图表生成
|
||||
|
||||
**支持的图表类型**
|
||||
|
||||
| 图表 | 适用场景 | 库 |
|
||||
|------|---------|-----|
|
||||
| 柱状图 | 对比数据 | matplotlib / plotly |
|
||||
| 折线图 | 趋势变化 | matplotlib / plotly |
|
||||
| 饼图 | 占比分布 | matplotlib / plotly |
|
||||
| 散点图 | 相关性分析 | matplotlib / plotly |
|
||||
| 瀑布图 | 增减分解 | plotly |
|
||||
| 热力图 | 矩阵数据 | matplotlib / seaborn |
|
||||
| 雷达图 | 多维对比 | matplotlib |
|
||||
|
||||
**图表设计原则**
|
||||
|
||||
1. **标题即结论** — 图表标题描述洞察而非数据（"销售额同比增长 40%" vs "Q4 销售数据"）
|
||||
2. **极简配色** — 使用 2-3 种颜色，重点数据用强调色
|
||||
3. **去除噪音** — 删除网格线、多余边框、3D 效果
|
||||
4. **标注关键值** — 在图表上直接标注最重要的数据点
|
||||
5. **适当留白** — 图表不超过幻灯片面积的 60%
|
||||
|
||||
**生成图表的 Python 示例**
|
||||
|
||||
```python
|
||||
import matplotlib.pyplot as plt
|
||||
import matplotlib
|
||||
|
||||
matplotlib.rcParams['font.sans-serif'] = ['Microsoft YaHei', 'SimHei']
|
||||
matplotlib.rcParams['axes.unicode_minus'] = False
|
||||
|
||||
fig, ax = plt.subplots(figsize=(10, 6))
|
||||
categories = ['Q1', 'Q2', 'Q3', 'Q4']
|
||||
values = [120, 180, 240, 350]
|
||||
colors = ['#e0e0e0', '#e0e0e0', '#e0e0e0', '#4A90D9']
|
||||
|
||||
ax.bar(categories, values, color=colors, width=0.6)
|
||||
ax.set_title('Q4 营收突破 350 万，环比增长 46%', fontsize=16, fontweight='bold', pad=20)
|
||||
ax.spines['top'].set_visible(False)
|
||||
ax.spines['right'].set_visible(False)
|
||||
|
||||
for i, v in enumerate(values):
|
||||
ax.text(i, v + 5, f'{v}万', ha='center', fontsize=12)
|
||||
|
||||
plt.tight_layout()
|
||||
plt.savefig('chart_revenue.png', dpi=200, bbox_inches='tight')
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Workflow 3: 演讲备注生成
|
||||
|
||||
为每张幻灯片生成 45-60 秒的演讲稿：
|
||||
|
||||
**规则：**
|
||||
1. 开头：过渡语连接上一页（"接下来看...""那么..."）
|
||||
2. 中间：用口语化表达阐述幻灯片要点
|
||||
3. 结尾：用一句话总结本页核心信息
|
||||
4. 字数：中文约 150-200 字 ≈ 45-60 秒
|
||||
5. 标注停顿点：`[停顿]`、`[看向观众]`
|
||||
6. 标注交互点：`[提问]`、`[举手调查]`
|
||||
|
||||
**示例：**
|
||||
|
||||
```
|
||||
那么我们来看第一个关键发现。[停顿]
|
||||
|
||||
过去一个季度，我们的月活跃用户从 50 万增长到了 150 万，
|
||||
同比增长了 200%。[看向观众] 这是一个非常可喜的数字，
|
||||
但同时也带来了挑战。
|
||||
|
||||
大家可以看到右边的图表，随着用户量的激增，
|
||||
我们的服务器平均响应时间从 200 毫秒上升到了 800 毫秒，
|
||||
高峰期甚至出现过 5 秒的延迟。[停顿]
|
||||
|
||||
这意味着什么？如果我们不尽快扩容，
|
||||
用户体验将会显著下降，这直接影响留存率。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Workflow 4: 自评打分
|
||||
|
||||
生成完成后，用以下 rubric 评估质量：
|
||||
|
||||
| 维度 | 满分 | 评分标准 |
|
||||
|------|------|---------|
|
||||
| 结构逻辑 | 25 | 金字塔结构完整、论点 MECE |
|
||||
| 视觉设计 | 20 | 一致的配色、排版、留白 |
|
||||
| 数据可视化 | 20 | 图表清晰、标题即结论 |
|
||||
| 演讲备注 | 15 | 流畅、口语化、时间合适 |
|
||||
| 受众适配 | 10 | 语言风格匹配目标受众 |
|
||||
| 行动导向 | 10 | 明确的 CTA 和下一步 |
|
||||
|
||||
目标分数：≥ 80/100。低于 80 分时自动修订弱项。
|
||||
|
||||
---
|
||||
|
||||
## Output Format
|
||||
|
||||
### 格式 1: PPTX 文件（python-pptx）
|
||||
|
||||
使用 `python-pptx` 生成标准 PowerPoint 文件：
|
||||
|
||||
```python
|
||||
from pptx import Presentation
|
||||
from pptx.util import Inches, Pt
|
||||
from pptx.enum.text import PP_ALIGN
|
||||
|
||||
prs = Presentation()
|
||||
prs.slide_width = Inches(13.333)
|
||||
prs.slide_height = Inches(7.5)
|
||||
|
||||
slide_layout = prs.slide_layouts[6] # blank layout
|
||||
slide = prs.slides.add_slide(slide_layout)
|
||||
|
||||
title_shape = slide.shapes.add_textbox(Inches(0.8), Inches(0.5), Inches(11.7), Inches(1.2))
|
||||
tf = title_shape.text_frame
|
||||
tf.text = "Q4 营收同比增长 46%，超额完成目标"
|
||||
tf.paragraphs[0].font.size = Pt(28)
|
||||
tf.paragraphs[0].font.bold = True
|
||||
|
||||
notes_slide = slide.notes_slide
|
||||
notes_slide.notes_text_frame.text = "演讲备注内容..."
|
||||
|
||||
prs.save('presentation.pptx')
|
||||
```
|
||||
|
||||
### 格式 2: Marp Markdown
|
||||
|
||||
```markdown
|
||||
---
|
||||
marp: true
|
||||
theme: default
|
||||
paginate: true
|
||||
header: "公司名 | Q4 汇报"
|
||||
footer: "机密"
|
||||
---
|
||||
|
||||
# Q4 产品路线图汇报
|
||||
### 需要追加 30% 研发预算以支撑用户增长
|
||||
|
||||
**演讲者** | 日期
|
||||
|
||||
---
|
||||
|
||||
## 用户量爆发增长带来系统压力
|
||||
|
||||
- 月活从 50 万 → 150 万（+200%）
|
||||
- 服务器响应时间 200ms → 800ms
|
||||
- 用户投诉工单增长 3 倍
|
||||
|
||||
|
||||
|
||||
---
|
||||
```
|
||||
|
||||
转换命令：
|
||||
|
||||
```bash
|
||||
marp slides.md --pptx -o presentation.pptx
|
||||
marp slides.md --pdf -o presentation.pdf
|
||||
marp slides.md --html -o presentation.html
|
||||
```
|
||||
|
||||
### 格式 3: Reveal.js HTML
|
||||
|
||||
```html
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/reveal.js@4/dist/reveal.css">
|
||||
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/reveal.js@4/dist/theme/white.css">
|
||||
</head>
|
||||
<body>
|
||||
<div class="reveal">
|
||||
<div class="slides">
|
||||
<section>
|
||||
<h1>Q4 产品路线图汇报</h1>
|
||||
<p>需要追加 30% 研发预算以支撑用户增长</p>
|
||||
<aside class="notes">演讲备注...</aside>
|
||||
</section>
|
||||
<section>
|
||||
<h2>用户量爆发增长带来系统压力</h2>
|
||||
<ul>
|
||||
<li>月活从 50 万 → 150 万（+200%）</li>
|
||||
<li>服务器响应时间 200ms → 800ms</li>
|
||||
</ul>
|
||||
<aside class="notes">演讲备注...</aside>
|
||||
</section>
|
||||
</div>
|
||||
</div>
|
||||
<script src="https://cdn.jsdelivr.net/npm/reveal.js@4/dist/reveal.js"></script>
|
||||
<script>Reveal.initialize({ hash: true });</script>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
### 格式 4: PNG 图表
|
||||
|
||||
每张数据图表单独输出为 PNG，分辨率 ≥ 200 DPI。
|
||||
|
||||
---
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
### 1. 标题写成了"主题词"而非"结论"
|
||||
|
||||
**错误**：幻灯片标题 "Q4 销售数据"
|
||||
**正确**：幻灯片标题 "Q4 销售额同比增长 40%，超额完成年度目标"
|
||||
|
||||
### 2. 每页内容过多
|
||||
|
||||
每张幻灯片不超过 5 个要点，每个要点不超过 15 个汉字。当内容过多时拆分为多页。
|
||||
|
||||
### 3. 配色不一致
|
||||
|
||||
整套 PPT 使用同一配色方案。推荐的安全配色：
|
||||
- 主色 1 种 + 强调色 1 种 + 灰色系
|
||||
- 避免使用超过 4 种颜色
|
||||
|
||||
### 4. 图表与结论脱节
|
||||
|
||||
每张图表必须支撑其所在页的标题结论。如果图表无法直接证明标题，要么修改图表要么修改标题。
|
||||
|
||||
### 5. 忽略受众水平
|
||||
|
||||
- 给管理层：聚焦商业影响、省略技术细节
|
||||
- 给技术团队：可以深入架构、代码层面
|
||||
- 给客户：突出价值和收益
|
||||
|
||||
### 6. 中文字体兼容
|
||||
|
||||
使用 python-pptx 时确保指定中文字体：
|
||||
|
||||
```python
|
||||
from pptx.util import Pt
|
||||
paragraph.font.name = 'Microsoft YaHei'
|
||||
```
|
||||
|
||||
### 7. 演讲时间估算不准
|
||||
|
||||
中文演讲速度约 200-250 字/分钟。10 页幻灯片 × 1 分钟/页 = 10 分钟演讲。如果用户要求 30 分钟演讲，需要约 25-30 页内容。
|
||||
|
||||
---
|
||||
|
||||
## EXTEND.md 扩展
|
||||
|
||||
用户可在技能同目录下创建 `EXTEND.md` 添加：
|
||||
- 公司 PPT 模板路径
|
||||
- 品牌配色和字体
|
||||
- 常用 PPT 结构模板
|
||||
- 特定行业/场景的幻灯片范例
|
||||
Reference in New Issue
Block a user