| 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 坐标是否冲突）
创建流程：
lark-cli slides +create --title "{项目名} - Demo Day Pitch" --as bot
lark-cli slides xml_presentation.slide create --as bot \
--params '{"xml_presentation_id":"<ID>"}' \
--data "$(jq -n --arg content '<slide ...>...</slide>' '{slide:{content:$content}}')"
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 检查项追加：
输出格式
# {项目名称} 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+问题类型）
部署步骤
cp -r /path/to/pre-PP /efs/vibe_oh_agent/.claude/skills/pre-PP
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 会标记为"可选"。
