Run any Skill in Manus with one click

pre-pp

Stars5

Forks0

UpdatedJune 3, 2026 at 08:40

Pre Pitch Practice — 路演PPT迭代助手在正式 PP 评估之前，帮助创始人从零到一制作/迭代路演 deck。支持：大纲生成、PPT 制作（飞书Slides/PDF/PPTX/HTML）、逐页打磨、视觉优化。默认输出飞书 Slides（云端渲染，字体无忧，在线协作）。当用户提到"做PPT"、"改PPT"、"迭代deck"、"准备路演材料"、"pre PP"时触发。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

MiraclePlus

MiraclePlus/pre-pp

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Management AnalystsBusiness and Financial Operations Occupations·SOC 13-1111

SKILL.md

readonly

name	pre-pp
version	1.1.0
author	MiraclePlus CC Team
description	Pre Pitch Practice — 路演PPT迭代助手在正式 PP 评估之前，帮助创始人从零到一制作/迭代路演 deck。支持：大纲生成、PPT 制作（飞书Slides/PDF/PPTX/HTML）、逐页打磨、视觉优化。默认输出飞书 Slides（云端渲染，字体无忧，在线协作）。当用户提到"做PPT"、"改PPT"、"迭代deck"、"准备路演材料"、"pre PP"时触发。
trigger	["pre-pp, pre PP, pre-PP, 做PPT, 改PPT, 迭代deck, 准备路演, 制作deck, PPT迭代, 路演材料制作"]
tags	["pitch","ppt","deck","creation","iteration","miracleplus"]

pre-PP — 路演PPT迭代助手

Preamble (run first)

_SKILL_DIR="$(find .claude/skills/pre-pp -maxdepth 0 2>/dev/null && echo ".claude/skills/pre-pp" || echo "$HOME/.claude/skills/pre-pp")"
mkdir -p ~/.pre-pp/logs
_UPD=$(bash "$_SKILL_DIR/version-check.sh" 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true

If output shows UPGRADE_AVAILABLE <old> <new>: inform user that a newer version is available and suggest running cd "$_SKILL_DIR" && curl -sL "https://api.github.com/repos/MiraclePlus/pre-pp/tarball/main" | tar xz --strip-components=1 to upgrade. Then continue with the task regardless.

If output shows UP_TO_DATE or is empty: proceed silently.

概述

帮助 S26 创始人在正式 Pitch Practice 之前迭代路演 deck。从大纲到成品，支持多轮打磨。与 PP skill 的关系：PP 是评估已有材料，pre-PP 是制作/迭代材料。

核心定位：路演材料的"编辑器"+"顾问"。既能制作，也能诊断改进。

三种工作模式

模式	触发条件	输出
制作模式	用户说"做/写/生成 deck"	从零生成飞书 Slides（默认）/ HTML / PPTX
审阅模式	用户提供 PDF/PPT/截图 + "帮我看看/改改/优化"	逐页修改建议 + 重写方案
规划模式	用户提供 Markdown 分页文档	结构评审 + 内容补全 + 生成 deck

适用场景

创始人还没有 deck，需要从项目资料生成大纲和初稿
创始人有初版 deck，需要结构调整或内容重写
创始人想针对某几页进行定向打磨
路演日前最后冲刺，需要快速出稿
创始人写了 Markdown 分页规划稿，需要评审和制作
创始人有现成 PDF/PPT，需要具体的修改建议

技术栈

已安装在 ./ppt-tools/：

PptxGenJS — 程序化生成 .pptx
Sharp — 图片处理、渐变预渲染
Playwright + Chromium — HTML → 截图（用于 HTML deck 转 PPTX）
python-pptx — Python 端 PPTX 读写
markitdown — PPTX 文本提取分析

字体规则（PPTX 生成必读）

核心原则：PPTX 必须使用目标电脑上已预装的系统字体。用户电脑通常没有 Google Fonts（Inter、Noto Sans SC 等），缺失字体会导致 PowerPoint 自动替换，造成排版严重走样（文字溢出、行距错乱、元素重叠）。

PPTX 安全字体表（按优先级）：

用途	Windows 安全字体	macOS 安全字体	跨平台最安全
英文标题	Arial Black, Calibri Bold	Helvetica Neue Bold	Arial Bold
英文正文	Calibri, Segoe UI	Helvetica Neue	Arial
中文标题	Microsoft YaHei Bold, 微软雅黑粗体	PingFang SC Semibold	Microsoft YaHei Bold
中文正文	Microsoft YaHei, 微软雅黑	PingFang SC	Microsoft YaHei
数字/数据	Arial, Calibri	Helvetica Neue	Arial

生成规则：

PPTX 中 fontFace 只允许使用上表中的字体，禁止使用 Inter / Noto Sans SC / Source Han Sans 等需额外安装的字体
HTML deck 不受此限制（浏览器会通过 Google Fonts CDN 加载）
如果项目要求特殊字体（如品牌字体），必须在输出说明中注明"需安装 XX 字体"
数字和英文统一用 Arial（等宽感强，大数字显示清晰）
中文统一用 Microsoft YaHei（Windows/macOS 双端覆盖率最高的中文字体）

字体对照表（HTML → PPTX 映射）：

HTML (Google Fonts)	PPTX 替代
Inter	Arial
Noto Sans SC	Microsoft YaHei
Source Han Sans	Microsoft YaHei
Montserrat	Arial
Roboto	Calibri
Georgia	Georgia (安全)

输出格式选择：

格式	命令	适用场景
飞书 Slides	`--format feishu`（默认）	云端渲染、字体无忧、在线协作、一键分享
PDF + PPTX	`--format pptx`	路演日提交、打印分发（有字体风险）
网页 HTML deck	`--format html`	快速预览、高视觉品质、自带动效

默认输出为飞书 Slides。原因：云端渲染字体一致（思源黑体），不受用户电脑环境影响； PPTX 依赖本地字体，缺失字体会导致排版严重走样。仅在用户明确要求 .pptx 文件时才用 PPTX 模式。

执行流程

Phase 0: 上下文加载

识别项目名称（从用户输入或对话上下文）
加载项目 OH 资料（同 PP skill 的 Stage 3 路A）
加载 Pitch Practice 方法论：<your-project>/Pitch Practice/
若用户提供了现有 deck（PDF/PPT），用 markitdown 提取结构

Phase 0A: Markdown 分页规划解析（规划模式）

当创始人提供 Markdown 格式的 PPT 分页规划时：

识别格式（自动检测）：

# Slide 1: 封面
- 标题：xxx
- 副标题：xxx

# Slide 2: 痛点
- 核心数据：xxx
- 场景描述：xxx

或任何类似的分页结构（## 第1页、### Page 1、--- 分隔符等）。

解析流程：

自动识别分页标记（标题级别/分隔符/编号）
提取每页：标题、要点、数据、视觉指引
映射到标准结构（封面/痛点/方案/市场/团队/Traction/融资/尾页）
生成结构评审报告：
- 缺失模块（如缺 Why Now、缺 Traction）
- 顺序问题（如团队放太前、融资放中间）
- 内容密度（每页字数是否超标）
- 逻辑断裂（页间衔接是否自然）

输出：修订版大纲 + 改进建议 → 用户确认后进入 Phase 3 制作

Phase 0B: 已有 PDF/PPT 审阅（审阅模式）

当创始人提供已有的 PDF 或 PPT 文件时：

提取流程：

PDF → 用 Read 工具直接读取（支持图片识别）
PPT/PPTX → python3 -m markitdown {file} 提取文本结构
对每页提取：标题、正文、数据点、图表描述

诊断维度（6+4 检查）：

维度	检查内容	输出
结构完整性	PP手册6模块是否齐全	缺失/多余页标注
信息密度	每页字数、要点数	过载页/空白页标记
逻辑连贯	页间承接关系	断裂点 + 修复建议
数据支撑	关键论点有无数据佐证	需补充数据的位置
表达效率	是否啰嗦/是否断言式	精简重写方案
视觉合规	路演日强制要求	违规项 + 修复方法

合伙人视角快评（简化版，每人1句）：

陆奇：叙事/认知负荷
Max：产品定义清晰度
Peter：证据/数据质量
Xuwen：结构/表达效率

输出格式：

# {项目名} Deck 审阅报告

## 整体评级：⭐⭐⭐☆☆（3/5）

## 逐页诊断
| 页 | 当前内容摘要 | 问题 | 修改建议 |
|---|------------|------|---------|
| 1 | 封面：xxx | Logo过大，缺一句话定位 | 添加"一句话"，Logo缩小50% |
| 2 | 背景铺垫 | 浪费时间论证市场存在 | 删除，直接用断言开场 |
| 3 | ... | ... | ... |

## 结构建议
- 建议删除第X页（原因）
- 建议在第Y页后插入（内容）
- 建议调整顺序：A→B→C 改为 B→A→C（原因）

## 内容重写示例
### 第X页（重写前 vs 重写后）
**Before**: "我们发现在XXX领域存在着巨大的市场机会..."
**After**: "中国XXX市场年规模800亿，但80%仍在用Excel管理。"

## 合伙人快评
- 陆奇：{一句话}
- Max：{一句话}
- Peter：{一句话}
- Xuwen：{一句话}

## 下一步
1. {最高优先级修改}
2. {次优先级修改}
3. 修改完成后建议运行 `/PP` 做正式评估

Phase 1: 大纲对齐（Outline）

基于奇绩 PP 标准，生成/调整 deck 大纲：

标准结构（可调）：

1. 封面 — 项目名 + 一句话定位 + Logo
2. 问题/痛点 — 具体场景 + 量化数据
3. 解决方案 — 产品是什么 + 核心功能
4. 产品演示 — Demo截图/流程图
5. Why Now — 时机/技术变革
6. 市场 — TAM/SAM/SOM + 竞争格局
7. 商业模式 — 如何收费 + 单位经济
8. Traction — 关键指标 + 增长曲线
9. 团队 — 核心成员 + 相关经验
10. 融资 — 金额 + 资金用途 + 里程碑
11. 尾页 — 二维码 + 联系方式 + 展位号

对齐要求：

每页核心信息 ≤ 1 个（陆奇：一次传递一个核心信息）
页间逻辑衔接（上一页的结论引出下一页的问题）
总页数 10-14 页（2分钟pitch = 骨架，5分钟pitch = 完整叙事）
必须有用户确认后才进入制作阶段

Phase 1.5: 讲稿内容优化（Content Iteration）

新增功能：基于 2025S 奇绩创坛 57 个项目路演讲稿的最佳实践，自动优化讲稿内容。

触发时机：

审阅模式（Phase 0B）自动执行
制作模式用户确认大纲后自动执行
用户明确要求"优化讲稿内容"、"让讲稿更吸引人"时执行

优化规则（详见 references/pitch-content-rules.md）：

1. 第一页黄金规则

必须有简单易懂的产品定位：用类比法（"XX行业的Cursor"、"AI时代的企业黑客"）
5秒记忆测试：投资人听完能否立刻转述？
避免术语堆砌：不要用"平台"、"系统"、"方案"等虚词

2. 前三页30秒记忆测试

第1页：产品是什么（简单类比）
第2页：解决什么问题（具体场景+数据）
第3页：如何解决（核心能力+对比数据）

3. 吸睛度检查（6种钩子）

每页必须有至少1个"钩子"，防止台下投资人玩手机：

震撼数据："164亿美金"、"覆盖率提升3倍"
对比反差："他们7000万18个月 vs 我们3000美金1周"
反常识洞察："60%的提示词其实并非必要"
视觉冲击：产品demo、数据曲线
具体场景："GitHub因为MCP漏洞泄漏代码"
未来愿景："十年之后会比Salesforce做得更大"

4. 虚实结合叙事

前6页讲实在的：产品定义、具体痛点、核心能力、数据验证
后3-4页讲升华的：团队愿景、市场想象空间、使命宣言

输出格式：

## 讲稿内容优化建议

### 第一页优化
**当前**: "XXX智能系统"
**建议**: "XX行业的Cursor — 让XX从XX小时缩短到XX分钟"
**理由**: 用类比法让投资人一眼看懂

### 前三页记忆测试
- ✅ 第1页：产品定位清晰
- ⚠️ 第2页：缺少具体场景和数据
- ❌ 第3页：无对比数据，无法体现优势

### 吸睛度检查
| 页码 | 钩子类型 | 状态 | 建议 |
|------|---------|------|------|
| 1 | 简单类比 | ❌ | 改为"XX行业的Cursor" |
| 2 | 具体数据 | ⚠️ | 补充"去年XX公司因此损失XX亿" |
| 3 | 对比反差 | ✅ | 已有"速度提升10倍" |

### 虚实结合检查
- ✅ 前6页：数据充足，实在
- ❌ 后4页：缺少愿景升华，建议在第9页加入长期愿景

Phase 2: 内容填充（Content）

逐页填写：

标题：≤ 8 字，动词或名词开头
核心信息：≤ 30 字，这页想让投资人记住什么
支撑数据：具体数字、案例、截图描述
视觉指引：图/表/截图/对比图/流程图

写作标准（详见 references/pp-diagnostic-handbook.md 和 references/pitch-content-rules.md）：

单页文字 ≤ 80 字，正文字号不能太小
一页一重点，信息点 ≤ 5 个
数据 > 形容词，断言 > 论证
先结论后解释（金字塔原则）
用大白话，避免术语堆砌
产品先行（Max：先讲清产品是什么）
必须使用真实素材：产品实拍照片、团队真人照片、客户现场图，禁止纯文本/占位符堆砌
大屏幕可读性：所有文字必须确保后排观众清晰可见，字号不能太小、颜色不能太淡

Phase 3: 制作输出（Build）

默认输出目录：/home/ubuntu/AI_First/PP评估/decks/（所有格式统一放此处）

模式 A：飞书 Slides（默认，`--format feishu`）

通过 lark-cli slides API 程序化创建飞书演示文稿，云端渲染。

技术要点：

画布尺寸：960 × 540（飞书固定 16:9）
字体：飞书统一渲染为 思源黑体（Source Han Sans），无需指定 fontFamily
颜色格式：必须使用 rgba(R,G,B,A)；渐变色必须带百分比停靠点
XML namespace：http://www.larkoffice.com/sml/2.0
坐标属性：topLeftX/topLeftY/width/height（不是 x/y/w/h）
形状类型：type="text"（文本框）、type="rect"（矩形卡片）
图片：仅支持 file_token（先 +media-upload 上传），禁止 http 外链

参考文档（生成前必读，位于 ./references/lark-slides/）：

文档	何时读取
`xml-schema-quick-ref.md`	每次生成 XML 前必读，坐标/颜色/元素语法
`validation-checklist.md`	创建完成后必读，验证空白页/溢出/重叠
`troubleshooting.md`	遇到错误码时查阅（3350001/4001000 等）
`lark-slides-create.md`	新建演示文稿时参考
`lark-slides-replace-slide.md`	编辑已有页面时参考（block_replace/block_insert）
`lark-slides-media-upload.md`	上传图片时参考
`visual-planning.md`	规划每页视觉重心时参考
`slides_xml_schema_definition.xml`	XML 协议终极权威来源

生成后自动验证（按 validation-checklist.md 执行）：

xml_presentations.get 回读全文 XML
核对页数是否正确
检查是否有空白页（<data> 内无元素）
检查文字是否溢出画布边界（topLeftX + width > 960 或 topLeftY + height > 540）
检查元素是否重叠（相邻 shape 坐标是否冲突）

创建流程：

# 1. 创建演示文稿
lark-cli slides +create --title "{项目名} - Demo Day Pitch" --as bot

# 2. 逐页添加（用 jq 处理 XML 转义）
lark-cli slides xml_presentation.slide create --as bot \
  --params '{"xml_presentation_id":"<ID>"}' \
  --data "$(jq -n --arg content '<slide ...>...</slide>' '{slide:{content:$content}}')"

# 3. 设置权限（按 CLAUDE.md 飞书权限规则）
lark-cli drive permission.members create --as bot \
  --params '{"token": "<ID>", "type": "slides"}' \
  --data '{"member_id": "<union_id>", "member_type": "unionid", "perm": "full_access", "type": "user"}'

飞书 Slides XML 模板（最小可用）：

<slide xmlns="http://www.larkoffice.com/sml/2.0">
  <style>
    <fill><fillColor color="linear-gradient(135deg,rgba(11,10,26,1) 0%,rgba(45,27,105,1) 100%)"/></fill>
  </style>
  <data>
    <shape type="text" topLeftX="80" topLeftY="80" width="800" height="60">
      <content textType="headline" color="rgba(255,255,255,1)" fontSize="28" bold="true" textAlign="center">
        <p>标题文字</p>
      </content>
    </shape>
  </data>
</slide>

输出：飞书 Slides 链接（可直接在线演示/编辑/协作）

模式 B：PDF + PPTX（`--format pptx`）

流程：PptxGenJS 程序化生成 .pptx → Playwright 渲染为 PDF

每页 720pt x 405pt（16:9）
可参考 ./ppt-tools/layouts.js 中的版式坐标作为指引（非强制）
排版美观原则见下方「排版指引」
字体风险：依赖用户本地字体，缺失会导致走样

输出：

PPTX: PP评估/decks/{项目名}-deck-v{n}.pptx
PDF: PP评估/decks/{项目名}-deck-v{n}.pdf

模式 C：网页 HTML Deck（`--format html`）

参考风格（非强制，按项目调整）：

字体：Inter + Noto Sans SC（Google Fonts CDN 加载，无本地依赖）
深色底 + 高对比强调色（金/蓝/绿）
clamp() 响应式字号，标题 2-3.5rem，正文 0.9-1.1rem
底部留 25% 安全区，内容区最大宽度 1000px
参考范例：PP评估/decks/潇湘智控-路演日Deck-v1.html

输出：单 HTML 文件 → PP评估/decks/{项目名}-deck-v{n}.html

Phase 4: 迭代打磨（Iterate）

用户反馈后逐页修改：

"第3页太多字" → 精简到 ≤ 50 字
"缺少竞争对比" → 插入竞争矩阵页
"开场不够有力" → 用"断言+数据"替代背景铺垫
"顺序不对" → 调整页面顺序

每轮迭代后自动执行 PP 标准 mini-check：

30秒规则：前3页能否说清产品？
逻辑衔接：页间是否断裂？
记忆点：有没有投资人能转述的金句？

Phase 5: 路演日合规检查（Pre-flight）

最终输出前执行路演日强制要求检查：

Phase 6: 迭代日志（Iteration Log）

（必须执行，所有 agent 平台通用）

每次完成 deck 输出后（Phase 3 或 Phase 4 迭代后），追加一条记录到 ~/.pre-pp/logs/{项目名}.md。

日志文件位置：~/.pre-pp/logs/{项目名}.md（每个项目独立一个日志文件，统一存放在 ~/.pre-pp/logs/）。

写入方式（二选一）：

调用辅助脚本：bash <skill_dir>/log-entry.sh ~/.pre-pp/logs/{项目名}.md <project> <version> <mode> <query> --output <files...> --slides-url <url>
直接追加 markdown 到日志文件（格式如下）

日志条目格式：

---

## {项目名} - v{版本号} | {YYYY-MM-DD HH:MM}

- **Query**: {用户原始输入，截取前 200 字}
- **Mode**: 制作 / 审阅 / 规划
- **Output**:
  - `{文件名1.html}`
  - `{文件名2.pptx}`
  - 飞书 Slides: {URL}（如有）
- **Changes**: {本轮变更摘要，1-2 句}

触发规则：

Phase 3 首次输出 → 记录（v1）
Phase 4 每轮迭代完成 → 记录（v2, v3, ...）
审阅模式仅产出建议不生成文件时 → 不记录

Pre-flight 检查项追加：

迭代日志已更新（pre-pp-log.md）

输出格式

# {项目名称} Deck 迭代 v{版本号}

## 大纲确认
| # | 页面 | 核心信息 | 视觉形式 |
|---|------|---------|----------|
| 1 | 封面 | 一句话定位 | Logo + 标题 |
| 2 | 痛点 | 量化问题 | 数据图表 |
| ... | ... | ... | ... |

## 当前状态
- 版本：v{n}
- 变更：{本轮改了什么}
- 待确认：{需要用户决策的点}

## Mini-Check
| 检查项 | 状态 | 备注 |
|--------|------|------|
| 30秒清晰度 | Pass/Fail | ... |
| 页间逻辑 | Pass/Fail | ... |
| 记忆点 | Pass/Fail | ... |

## 文件输出
- PPTX: `PP评估/decks/{项目名}-deck-v{n}.pptx`
- PDF: `PP评估/decks/{项目名}-deck-v{n}.pdf`
- HTML: `PP评估/decks/{项目名}-deck-v{n}.html`（仅 --format html 时）

审阅诊断依据

审阅模式（Phase 0B）使用 PP诊断手册 作为核心评估标准：

参考文档：references/pp-diagnostic-handbook.md 来源：MPR | 校友PP参考手册(F25)

6维诊断框架

维度	核心检查项	常见问题数
1. What（做什么）	30秒清晰度、一句话定位、视觉一致性	3类
2. Why Now（痛点）	场景化、新信息量、信服力、时间分配	7类
3. How（产品方案）	可视化、一致性、技术翻译、聚焦度	9类
4. Why/市场	TAM-SAM-SOM、入口客户、商业模式	4类
5. Why Us（团队）	匹配度、记忆标签、分工、互补性	5类
6. Traction（进展）	量化、时间线、增长曲线、视觉突出	4类

审阅输出格式

示例：

与 PP Skill 的协作

pre-PP 制作完成后，建议用户运行 /PP 做正式评估
pre-PP 的 mini-check 是 PP 完整评估的子集（快速检查）
PP 的评估结果可直接作为 pre-PP 下一轮迭代的输入

设计规范速查

配色方案（推荐）

方案	背景	主色	强调色	适用
深蓝科技	#0A1628	#FFFFFF	#3B82F6	AI/SaaS/数据
暖白商务	#FAFAFA	#1A1A1A	#FF6B35	消费/服务/平台
深绿生物	#0D1F22	#E8F5E9	#4CAF50	生物/医疗/环保
纯黑硬件	#000000	#FFFFFF	#FFD700	硬件/机器人/工业

字体配对

标题	正文	风格
Inter Bold	Inter Regular / Noto Sans SC	科技/现代
Georgia Bold	Calibri	商务/稳重
Arial Black	Arial	简洁/通用

排版指引（生成时作为 prompt 参考，非代码硬约束）

字号层级（路演日大屏必须后排可读，这是硬性底线）：

⚠️ 最低字号规则（强制执行）：正文/要点 ≥ 24pt，任何页面不得出现低于 18pt 的文字。路演现场后排观众距屏幕 15-20 米，小于 24pt 的正文在大屏上几乎不可读。宁可减少每页信息量，也不能缩小字号。

封面标题：48-54pt
页面标题：30-36pt
正文/要点：24-28pt（硬性最低 24pt）
说明/注释：18-20pt（硬性最低 18pt）
页码：不显示（路演 deck 无需页码）

飞书 Slides 960px 画布下，上述字号视觉效果约等于 PPTX 中放大 1.3 倍。如果每页信息放不下，优先拆页，而非缩小字号。

空间分配：

内容集中在页面上方 70%，底部 30% 留白（路演厅前排观众会遮挡）
左右边距 ≥ 80px（960px 画布的 ~8%）
元素之间留足呼吸空间，不要贴着放
单页信息点 ≤ 5 个

排版模式（二选一）：

左对齐（默认）：标题 + 正文统一左对齐，阅读节奏流畅，适合信息密集页
居中：封面、关键数据页、金句页可用居中排版，制造视觉冲击

布局策略（防空间浪费，核心规则）：

根据每页信息量自动选择布局，严禁出现"内容全堆左侧、右侧大面积空白"的情况：

信息量	推荐布局	宽度利用
≤2 条关键信息	居中大字 + 大量留白	内容区居中，宽度 500-700px
3-5 条并列信息	卡片网格（2×2 或 1+2×2）	铺满 720px 内容区（左右各留 120px）
6+ 数据点	2×3 或 3×2 网格	铺满 800px（左右各留 80px）
对比类（A vs B）	左右双栏，等宽	各占 ~380px，中间 20px gap
流程类（步骤）	水平 flow + 箭头	等宽等距，铺满可用宽度
人物/团队介绍	居中标题 + 卡片网格	姓名居中，能力/经历用卡片铺满
列表（bullet points）	居中标题 + 宽文本框	文本框宽度 ≥ 700px，不要窄到只占半页

常见布局错误（严禁）：

❌ 内容全部 topLeftX=80 左对齐，右侧 400px+ 完全空白
❌ 列表项用窄文本框（width < 500），导致右半页浪费
❌ 标题左对齐但正文居中（或反过来），视觉不统一
❌ 所有页面用同一种布局（全部左对齐 bullets），缺乏节奏变化
❌ 数据网格各列宽度不等、间距不一致

正确做法：

人物介绍页：姓名/角色居中 → 能力卡片 2×2 或 2×3 网格铺满
数据页：标题居中 → 数据网格等间距、等列宽、严格对齐
故事/时间线页：左侧数字 + 右侧说明，数字右对齐、说明左对齐、两者边界统一
对比页：左右完全对称，标题居中

飞书 Slides 专用坐标参考（960×540 画布）：

布局类型	内容区 X 范围	内容区 Y 范围	示例
全宽居中	80-880	40-380	封面、愿景金句
三列网格	80/350/620 (各 w=260)	90-320	数据指标、三卡片
两列对比	80/500 (各 w=380)	160-380	Before/After
大数字+说明	数字 80-240, 说明 260-880	每行高 60-80	故事页
居中卡片组	120-840 (总 w=720)	150-380	人物/能力展示

分栏规则：

仅在对比场景允许分栏（Before vs After、竞品对比、方案A vs B）
禁止无对比语义的并列分栏（容易显得杂乱、信息分散）
单栏通篇为默认，除非内容天然是对比结构

图标/Icon 使用规则：

非必要禁止使用 icon——icon 堆砌是典型 AI 生成感的来源
唯一允许场景：icon 确实比文字更高效传达语义（如对勾/叉表示功能对比、箭头表示流程方向）
禁止：bullet 前加装饰 icon、每个要点配一个 icon、用 icon 做页面点缀
替代方案：用数据、留白、字号层级、颜色强调来建立视觉节奏

对齐与美观：

同一页的文字框左边缘对齐（或统一居中）
相邻元素间距保持一致（飞书 Slides 中 ≥ 15px）
文字框不要互相重叠
内容少时大胆留白，不要为了填满而堆砌
Bullet 要点每页 3-4 条为佳，每条简短有力
网格布局必须严格等间距、等列宽——差 1px 都会显得不专业

使用示例

# 制作模式（默认输出飞书 Slides）
/pre-PP Meridian 帮我从零做一个5分钟路演deck
/pre-PP VoiceCursor 基于最新OH内容更新deck
/pre-PP 潇湘智控 --format html 生成HTML预览版
/pre-PP 慧化科技 --format pptx 生成本地PPTX文件

# 转换已有 HTML deck 到飞书 Slides
/pre-PP StudySpace 把 PP评估/decks/StudySpace-deck-v2.html 转成飞书slides

# 编辑已有飞书 Slides
/pre-PP Meridian 帮我改这个飞书slides的第3页 https://miracleplus.feishu.cn/slides/xxx

# 审阅模式（提供已有 PDF/PPT）
/pre-PP 慧化科技 帮我看看这个deck哪里需要改 [附件: deck.pdf]
/pre-PP 深智构DeepGigoAI /tmp/deepgigo-pitch.pptx 给修改建议

# 规划模式（提供 Markdown 分页稿）
/pre-PP Meridian 基于下面的分页规划帮我做deck：
## Slide 1: 封面 ...
## Slide 2: 痛点 ...

# 定向打磨
/pre-PP 慧化科技 我现在的deck第3-5页太啰嗦，帮我精简
/pre-PP 深智构DeepGigoAI 帮我重写开场，要更有冲击力

补充说明

所有输出文件保存到 /home/ubuntu/AI_First/PP评估/decks/{项目名}-deck-v{n}.[pptx|pdf|html]
迭代记录保存到 /home/ubuntu/AI_First/PP评估/decks/{项目名}-deck-v{n}.md
S26 项目自动加载最新 OH 上下文
首次制作会执行需求澄清（风格/受众/时长/素材）
输出的 HTML deck（--format html）可直接在浏览器全屏演示
NODE_PATH 设置：export NODE_PATH=./ppt-tools/node_modules

Skill 路由调度（自动选择下游 Skill）

pre-PP 根据任务类型自动调用最合适的已安装 Skill，无需用户手动指定。

路由表

任务类型	首选 Skill	备选 Skill	触发条件
PPTX 生成（程序化）	ppt-workflow	pptx-generator	--format pptx；用户要求"PPT文件"
HTML → PPTX 转换	html-to-pptx	—	已有 HTML deck，需转为 .pptx 提交
学术/科研演示	scientific-slides	pptx-from-layouts	项目属 biotech/AI4S/学术方向
咨询级商务 Deck	presentation-consulting	ppt-workflow	用户要求"专业/商务/投行风格"
模板化 PPTX（已有模板）	pptx-from-layouts	pptx-generator	用户提供 .pptx 模板文件
PDF 读取/解析	pdf	—	输入为 PDF 文件（审阅模式）
幻灯片结构设计	slides	pptx-generator	纯结构/大纲阶段，快速原型

调度逻辑

组合调用场景

场景	调用链
从零做路演 deck（HTML）	pre-PP Phase 0-2 → guizang-ppt-skill（渲染）
从零做路演 deck（PPTX）	pre-PP Phase 0-2 → ppt-workflow（生成 .pptx）
HTML deck 转交付文件	guizang-ppt-skill（生成 HTML）→ html-to-pptx（转 .pptx）
审阅已有 PDF	pdf（提取内容）→ pre-PP Phase 0B（诊断）
审阅已有 PPTX	pptx（解析结构）→ pre-PP Phase 0B（诊断）
基于模板重做	pptx-from-layouts（套用模板）→ pre-PP Phase 4（迭代）
学术项目路演	pre-PP Phase 0-2 → scientific-slides（学术排版）
商务融资 deck	pre-PP Phase 0-2 → presentation-consulting（咨询风格）

Skill 路径速查

自动路由示例

Skill 路由调度（自动选择下游 Skill）

pre-PP 根据任务类型自动调用最合适的已安装 Skill，无需用户手动指定。

路由表

任务类型	首选 Skill	备选 Skill	触发条件
PPTX 生成（程序化）	ppt-workflow	pptx-generator	`--format pptx`；用户要求"PPT文件"
HTML → PPTX 转换	html-to-pptx	—	已有 HTML deck，需转为 .pptx 提交
学术/科研演示	scientific-slides	pptx-from-layouts	项目属 biotech/AI4S/学术方向
咨询级商务 Deck	presentation-consulting	ppt-workflow	用户要求"专业/商务/投行风格"
模板化 PPTX（已有模板）	pptx-from-layouts	pptx-generator	用户提供 .pptx 模板文件
PDF 读取/解析	pdf	—	输入为 PDF 文件（审阅模式）
幻灯片结构设计	slides	pptx-generator	纯结构/大纲阶段，快速原型

调度逻辑

1. 解析用户意图 -> 确定任务类型（制作/审阅/转换/解析）
2. 检查输入格式（Markdown / PDF / PPTX / 无文件）
3. 检查输出格式要求（HTML / PPTX / 两者都要）
4. 检查项目领域标签（科技/消费/生物/硬件/学术）
5. 匹配路由表 -> 调用对应 Skill 的方法论和模板

组合调用场景

场景	调用链
从零做路演 deck（PPTX）	pre-PP Phase 0-2 -> ppt-workflow（生成 .pptx）
审阅已有 PDF	pdf（提取内容） -> pre-PP Phase 0B（诊断）
审阅已有 PPTX	pptx-generator（解析结构） -> pre-PP Phase 0B（诊断）
基于模板重做	pptx-from-layouts（套用模板） -> pre-PP Phase 4（迭代）
学术项目路演	pre-PP Phase 0-2 -> scientific-slides（学术排版）
商务融资 deck	pre-PP Phase 0-2 -> presentation-consulting（咨询风格）

Skill 路径速查

./
  ppt-workflow/              # 端到端流水线，26风格，18图表类型
  html-to-pptx/             # HTML -> 原生PPTX形状转换
  scientific-slides/         # 学术PPTX，437 stars
  pptx-from-layouts/         # Markdown -> 模板PPTX映射
  presentation-consulting/   # 咨询级商务deck
  pdf/                       # PDF生成与解析
  pptx-generator/            # 程序化PPTX生成
  slides/                    # 幻灯片结构设计

自动路由示例

用户: "/pre-PP Meridian 帮我从零做一个5分钟路演deck"
  路由: ppt-workflow（默认 PDF+PPTX 输出）
  调用链: Phase 0 -> 1 -> 2 -> 3A (ppt-workflow渲染)

用户: "/pre-PP VoiceCursor --format html"
  路由: HTML deck 渲染
  调用链: Phase 0 -> 1 -> 2 -> 3B (HTML输出)

用户: "/pre-PP 慧化科技 帮我看看 deck.pdf"
  路由: pdf（解析） -> pre-PP Phase 0B（诊断）
  输出: 审阅报告 + 修改建议

用户: "/pre-PP 从分子设计到科学创新 做个学术风格的deck"
  路由: scientific-slides（学术排版）
  调用链: Phase 0 -> 1 -> 2 -> 3 (scientific-slides渲染)

用户: "把刚才的HTML deck转成pptx文件"
  路由: html-to-pptx
  输入: 已生成的HTML -> 输出: .pptx

部署与依赖安装

本 skill 自包含所有依赖声明，copy 到生产环境后执行 setup 即可。

目录结构

pre-PP/
  SKILL.md              # 主 skill 定义
  setup.sh              # 一键安装脚本
  requirements.txt      # Python 依赖声明
  ppt-tools/
    package.json        # Node 依赖声明（含 postinstall 自动装 chromium）
  references/
    pp-diagnostic-handbook.md  # PP诊断手册（6维度40+问题类型）

部署步骤

# 1. Copy skill 到生产目录
cp -r /path/to/pre-PP /efs/vibe_oh_agent/.claude/skills/pre-PP

# 2. 一键安装所有依赖
cd /efs/vibe_oh_agent/.claude/skills/pre-PP
bash setup.sh

依赖清单

类型	包	用途
Python	python-pptx	PPTX 读写解析
Python	markitdown	PPT/PDF 文本提取
Node	pptxgenjs	程序化生成 PPTX
Node	sharp	图片处理/渐变预渲染
Node	playwright + chromium	HTML 截图转 PPTX
Node	lucide-static	图标素材（仅对比/流程图场景可用，默认不使用）

环境变量

export NODE_PATH=<skill_dir>/ppt-tools/node_modules

输出目录

所有输出统一放到：/home/ubuntu/AI_First/PP评估/decks/

PPTX: {项目名}-deck-v{n}.pptx（默认）
PDF: {项目名}-deck-v{n}.pdf（默认）
HTML: {项目名}-deck-v{n}.html（--format html）
迭代记录: {项目名}-deck-v{n}.md

环境自检

本地渲染（PPTX/PDF/HTML）需要字体和 Chromium。首次安装后运行：

bash verify.sh        # 检查环境
bash verify.sh --fix  # 自动修复缺失项

若仅使用飞书 Slides 输出（默认），可跳过字体和 Chromium，verify.sh 会标记为"可选"。

pre-pp

pre-PP — 路演PPT迭代助手

Preamble (run first)

概述

三种工作模式

适用场景

技术栈

字体规则（PPTX 生成必读）

执行流程

Phase 0: 上下文加载

Phase 0A: Markdown 分页规划解析（规划模式）

Phase 0B: 已有 PDF/PPT 审阅（审阅模式）

Phase 1: 大纲对齐（Outline）

Phase 1.5: 讲稿内容优化（Content Iteration）

1. 第一页黄金规则

2. 前三页30秒记忆测试

3. 吸睛度检查（6种钩子）

4. 虚实结合叙事

Phase 2: 内容填充（Content）

Phase 3: 制作输出（Build）

模式 A：飞书 Slides（默认，--format feishu）

模式 B：PDF + PPTX（--format pptx）

模式 C：网页 HTML Deck（--format html）

Phase 4: 迭代打磨（Iterate）

Phase 5: 路演日合规检查（Pre-flight）

Phase 6: 迭代日志（Iteration Log）

输出格式

审阅诊断依据

6维诊断框架

审阅输出格式

与 PP Skill 的协作

设计规范速查

配色方案（推荐）

字体配对

排版指引（生成时作为 prompt 参考，非代码硬约束）

使用示例

补充说明

Skill 路由调度（自动选择下游 Skill）

路由表

调度逻辑

组合调用场景

Skill 路径速查

自动路由示例

Skill 路由调度（自动选择下游 Skill）

路由表

调度逻辑

组合调用场景

Skill 路径速查

自动路由示例

部署与依赖安装

目录结构

部署步骤

依赖清单

环境变量

输出目录

环境自检

pre-PP — 路演PPT迭代助手

Preamble (run first)

概述

三种工作模式

适用场景

技术栈

字体规则（PPTX 生成必读）

执行流程

Phase 0: 上下文加载

Phase 0A: Markdown 分页规划解析（规划模式）

Phase 0B: 已有 PDF/PPT 审阅（审阅模式）

Phase 1: 大纲对齐（Outline）

Phase 1.5: 讲稿内容优化（Content Iteration）

1. 第一页黄金规则

2. 前三页30秒记忆测试

3. 吸睛度检查（6种钩子）

4. 虚实结合叙事

Phase 2: 内容填充（Content）

Phase 3: 制作输出（Build）

模式 A：飞书 Slides（默认，--format feishu）

模式 B：PDF + PPTX（--format pptx）

模式 C：网页 HTML Deck（--format html）

Phase 4: 迭代打磨（Iterate）

Phase 5: 路演日合规检查（Pre-flight）

模式 A：飞书 Slides（默认，`--format feishu`）

模式 B：PDF + PPTX（`--format pptx`）

模式 C：网页 HTML Deck（`--format html`）

模式 A：飞书 Slides（默认，`--format feishu`）

模式 B：PDF + PPTX（`--format pptx`）

模式 C：网页 HTML Deck（`--format html`）