goodbuddy/resources/skills/product-presentation/SKILL.md

name, version, description, allowed-tools, compatibility

name	version	description	allowed-tools	compatibility
product-presentation	1.0.0	生成面向特定受众的产品介绍 PPT、逐页叙事和演讲备注。用于产品发布、客户宣讲、 售前交流或内部汇报；不负责现场产品操作步骤，操作型演示应使用 sales-demo-kit。	Read Grep Glob Execute	生成 PPTX 需 python-pptx 1.0+

产品介绍 PPT

必要输入

• 已核验的产品事实、功能、参数、案例授权和适用边界。
• 受众角色、演示目标、场合、时长、页数和品牌要求。
• 可用图片、架构图、截图及其授权范围。

先写一句演示目标，例如“让技术负责人理解部署边界并同意进入 POC”，再决定页序。

推荐叙事

按任务选择，不机械套用全部页面：

1. 封面与本次议题。
2. 受众当前面临的具体问题。
3. 产品定位和适用范围。
4. 核心工作流或架构。
5. 关键能力，按场景组织，不按后台菜单朗读。
6. 已核验参数、兼容性或安全边界。
7. 获准公开的案例或验证结果。
8. 部署、交付和下一步。

页面纪律

• 一页只有一个结论，标题直接写该页内容。
• 正文优先 3 至 5 个要点，每个要点只表达一个信息。
• 数字必须带条件和来源，不使用无依据的百分比。
• 规划能力、试用能力和当前能力使用不同标识。
• 讲稿可以补充上下文，但不能引入幻灯片中没有依据的新事实。
• 不把产品介绍写成按钮操作手册，也不使用满页功能清单。

生成 PPTX

先探测可用的 Python 3 解释器：Windows 优先使用 python，macOS/Linux 优先使用 python3。下文 <python> 表示探测成功的解释器命令。

复制并填写 templates/deck.example.json：

<python> -m pip install -r "<skill-dir>/requirements.txt"
<python> "<skill-dir>/scripts/build_pptx.py" \
  --input ./build/deck.json \
  --output ./dist/product-presentation.pptx

deck.json 与配图是中间产物，放在 build/；交付物 PPTX 放在 dist/。复核用 PDF 和页面截图一律写入 build/check/，不得与 PPTX 同目录。

构建器支持封面、章节页、要点页、双栏页、指标页、图片页和收尾页。它负责稳定 排版，不负责补写内容；deck.json 中的文字必须先通过事实审查。

除章节页外每页必须提供非空 notes，否则构建失败。图片必须放在 deck.json 所在目录内，超过 40MB 或 8000 万像素会被拒绝；其余图片按版面尺寸和 150 DPI 重采样后嵌入，避免生成超大文件。

视觉复核

1. 使用 LibreOffice 或 PowerPoint 打开并导出 PDF；该 PDF 仅用于复核，交付物是 PPTX，复核后应删除。LibreOffice 需安装 Impress 组件，仅装 Writer 时无法转换。
2. 检查文字溢出、孤行、图片拉伸、低清截图和字号过小。
3. 快速朗读全套讲稿，确认时间预算和页面转场自然。
4. 核对所有数字、版本、案例名称和产品状态与事实清单一致。

完成标准

PPTX 可打开；页数和时长符合简报；每页目标明确；视觉层级统一；备注完整；无 未经授权的客户信息、竞品结论或内部证据路径。