mcpField
P
paw-tools-presentation

paw-tools-presentation

github.com/pawbytes文档处理115142 次安装4 周前更新
代码仓库

关于 paw-tools-presentation

将营销计划、策略和报告转为独立 HTML 演示文稿的 Skill,采用 SCR/金字塔结构,并根据内容调整设计。

主要功能

  1. 01分阶段导入、梳理与生成
  2. 02SCR 与金字塔原则结构
  3. 03内嵌 Chart.js 图表
  4. 04PDF 下载按钮
  5. 05可选品牌配置

适用场景

  1. 01将营销报告转为演示文稿
  2. 02用结构化叙事呈现策略
  3. 03制作包含图表的 HTML 演示文稿

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pawbytes/skill-suites --skill paw-tools-presentation

安装后在 Claude Code 中输入/paw-tools-presentation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/2x2_matrix_template/
code.html
assets/agenda_template/
code.html
assets/data_visualization_template/
code.html
assets/executive_summary_scr_template/
code.html
assets/kinetic_insight_colour_template/
DESIGN.md
assets/pyramid_content_template/
code.html
assets/section_divider_template/
code.html
assets/team_contact_template/
code.html
assets/title_slide_template/
code.html
references/
01-ingest.md
02-outline.md
03-generate.md
chart-patterns.md
html-template.md
mckinsey-scr-guide.md

详细介绍

演示文稿制作工具

概述

使用 McKinsey 金字塔原理 / SCR(情境-复杂情况-解决方案)结构,将营销策略、计划和报告转化为精美的 HTML 演示文稿。充当演示文稿策略师,兼具视觉传播与高管级叙事能力。

功能: 导入营销内容(来自 paw-mkt-* 技能或原始输入),将其整理为 SCR 格式,并生成包含 Chart.js 图表和主视觉图片的专业 HTML 文档。

工作方式: 三阶段渐进流程——导入 → 组织结构 → 生成。每个阶段完成后才会进入下一阶段。

输出: 独立 HTML 文件,内嵌 CSS、Chart.js 和 PDF 下载按钮,保存至 {project-root}/.pawbytes/tools-output/presentations/。每份演示文稿都有独特的视觉风格——设计会根据内容类型、受众和品牌特征调整,而不是遵循固定模板。

激活时

加载 {project-root}/.pawbytes/config/config.yaml 和 {project-root}/.pawbytes/config/config.user.yaml 中可用的配置。如果存在配置,请提取:

  • communication_language(默认:英语)
  • document_output_language(默认:英语)

如果 {project-root}/.pawbytes/tools-output/paw-mkt-setup/brand-config.json 存在,则读取品牌配置,并用于颜色、字体排版和品牌语调。

默认输出路径: {project-root}/.pawbytes/tools-output/presentations/(或配置中的 presentation_output_folder)

无头模式

使用 --headless 或 -H 调用时:

  • 跳过用户对大纲的审核
  • 对所有选项使用合理的默认值
  • 无需交互即可生成完整的 HTML 输出
  • 如果存在品牌配置则读取;否则使用专业的默认设置

阶段

阶段 1:导入内容

加载 ./references/01-ingest.md

输入来源:

  • 来自 paw-mkt-* 技能的营销内容(通过 --from-skill <skill-name> 传入)
  • Markdown / 文本文件的路径
  • 直接提供的原始文本

进度: 内容已导入并理解 → 进入组织结构阶段

阶段 2:组织大纲

加载 ./references/02-outline.md

结果: 向用户展示 McKinsey SCR / 金字塔大纲供其审核。用户可以编辑、添加、删除或重新组织各个部分。

进度: 用户批准大纲 → 进入生成阶段

阶段 3:生成 HTML

加载 ./references/03-generate.md

结果: 完整的 HTML 文档,包含:

  • 与品牌风格一致的专业样式(如已配置)
  • 用于呈现数据的 Chart.js 图表
  • 主视觉 / 封面图片(Pexels API 或 Gen AI)
  • 通过 window.print() 实现的 PDF 下载按钮

使用的外部技能

  • paw-mkt-setup — 品牌配置来源(可选集成)

输出

位置: {presentation_output_folder} 或 {project-root}/.pawbytes/tools-output/presentations/{slugified-title}.html

文件名约定: 将演示文稿标题转换为 slug 格式。

图片来源

有两种可选方案:

  1. Pexels API — 免费图库照片。需要在配置中设置 pexels_api_key。
  2. fal.ai — AI 生成的图片。需要在配置中设置 fal_api_key。

如果未配置 API 密钥,请使用专业占位图片,或提示用户提供图片。

图表

Chart.js 直接嵌入 HTML 输出中。支持的类型:

  • 柱状图(对比)
  • 折线图(随时间变化的趋势)
  • 饼图 / 圆环图(占比、市场份额)
  • 散点图(相关性)

实现模式请参阅 ./references/chart-patterns.md。

评论

支持 Markdown