diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 871c960..444a9e2 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -6,7 +6,7 @@ }, "metadata": { "description": "Skills shared by Baoyu for improving daily work efficiency", - "version": "1.17.1" + "version": "1.18.0" }, "plugins": [ { diff --git a/CHANGELOG.md b/CHANGELOG.md index d2cde22..aa2204c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,19 @@ English | [中文](./CHANGELOG.zh.md) +## 1.18.0 - 2026-01-23 + +### Features +- `baoyu-slide-deck`: introduces dimension-based style system—replaces monolithic style definitions with modular 4-dimension architecture: **Texture** (clean, grid, organic, pixel, paper), **Mood** (professional, warm, cool, vibrant, dark, neutral), **Typography** (geometric, humanist, handwritten, editorial, technical), and **Density** (minimal, balanced, dense). 16 presets map to specific dimension combinations, with "Custom dimensions" option for full flexibility. +- `baoyu-slide-deck`: adds two-round confirmation workflow—Round 1 asks style/audience/slides/review preferences, Round 2 (optional) collects custom dimension choices when user selects "Custom dimensions". +- `baoyu-slide-deck`: adds conditional outline and prompt review—users can skip reviews for faster generation or enable them for more control. + +### Documentation +- `baoyu-slide-deck`: adds dimension reference files—`references/dimensions/texture.md`, `references/dimensions/mood.md`, `references/dimensions/typography.md`, `references/dimensions/density.md`, and `references/dimensions/presets.md` (preset → dimension mapping). +- `baoyu-slide-deck`: adds design guidelines—`references/design-guidelines.md` with audience principles, visual hierarchy, content density, color selection, typography, and font recommendations. +- `baoyu-slide-deck`: adds layout reference—`references/layouts.md` with layout options and selection tips. +- `baoyu-slide-deck`: adds preferences schema—`references/config/preferences-schema.md` for EXTEND.md configuration. + ## 1.17.1 - 2026-01-23 ### Refactor diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md index 2813ef7..a7afe59 100644 --- a/CHANGELOG.zh.md +++ b/CHANGELOG.zh.md @@ -2,6 +2,19 @@ [English](./CHANGELOG.md) | 中文 +## 1.18.0 - 2026-01-23 + +### 新功能 +- `baoyu-slide-deck`:引入基于维度的风格系统——将单一风格定义重构为模块化四维架构:**纹理** (clean 纯净、grid 网格、organic 有机、pixel 像素、paper 纸张)、**氛围** (professional 专业、warm 温暖、cool 冷静、vibrant 鲜艳、dark 暗色、neutral 中性)、**字体** (geometric 几何、humanist 人文、handwritten 手写、editorial 编辑、technical 技术)、**密度** (minimal 极简、balanced 均衡、dense 密集)。16 种预设映射到特定维度组合,并提供「自定义维度」选项实现完全灵活配置。 +- `baoyu-slide-deck`:新增两轮确认工作流——第一轮询问风格/受众/页数/审核偏好,第二轮(可选)在用户选择「自定义维度」时收集具体维度选择。 +- `baoyu-slide-deck`:新增条件性大纲和提示词审核——用户可跳过审核以加快生成,或启用审核以获得更多控制。 + +### 文档 +- `baoyu-slide-deck`:新增维度参考文件——`references/dimensions/texture.md`、`references/dimensions/mood.md`、`references/dimensions/typography.md`、`references/dimensions/density.md`,以及 `references/dimensions/presets.md`(预设到维度的映射)。 +- `baoyu-slide-deck`:新增设计指南——`references/design-guidelines.md`,包含受众原则、视觉层次、内容密度、配色选择、字体排版和字体推荐。 +- `baoyu-slide-deck`:新增布局参考——`references/layouts.md`,包含布局选项和选择技巧。 +- `baoyu-slide-deck`:新增偏好配置模式——`references/config/preferences-schema.md`,用于 EXTEND.md 配置。 + ## 1.17.1 - 2026-01-23 ### 重构 diff --git a/README.md b/README.md index 2dfb411..ef2f2bc 100644 --- a/README.md +++ b/README.md @@ -297,6 +297,9 @@ Generate professional slide deck images from content. Creates comprehensive outl /baoyu-slide-deck path/to/article.md --style corporate /baoyu-slide-deck path/to/article.md --audience executives +# Target slide count +/baoyu-slide-deck path/to/article.md --slides 15 + # Outline only (no image generation) /baoyu-slide-deck path/to/article.md --outline-only @@ -304,25 +307,50 @@ Generate professional slide deck images from content. Creates comprehensive outl /baoyu-slide-deck path/to/article.md --lang zh ``` -**Styles** (visual aesthetics): +**Options**: -| Style | Description | Best For | -|-------|-------------|----------| -| `blueprint` (default) | Technical schematics, grid texture, engineering precision | Architecture, system design | -| `notion` | SaaS dashboard aesthetic, card-based layouts, clean data focus | Product demos, SaaS, B2B | -| `bold-editorial` | High-impact magazine style, bold typography, dark backgrounds | Product launches, keynotes | -| `corporate` | Navy/gold palette, structured layouts, professional icons | Investor decks, proposals | -| `dark-atmospheric` | Cinematic dark mode, glowing accents, atmospheric depth | Entertainment, gaming, creative | -| `editorial-infographic` | Magazine-style explainers, flat illustrations | Tech explainers, research | -| `fantasy-animation` | Whimsical Ghibli/Disney style, hand-drawn animation | Educational, storytelling | -| `intuition-machine` | Technical briefing, bilingual labels, aged paper texture | Technical docs, bilingual | -| `minimal` | Ultra-clean, maximum whitespace, single accent color | Executive briefings, premium | -| `pixel-art` | Retro 8-bit aesthetic, chunky pixels, nostalgic gaming | Gaming, developer talks | -| `scientific` | Academic diagrams, biological pathways, precise labeling | Biology, chemistry, medical | -| `sketch-notes` | Hand-drawn feel, soft brush strokes, warm background | Educational, tutorials | -| `vector-illustration` | Flat vector, black outlines, retro soft colors | Creative proposals, explainers | -| `vintage` | Aged-paper aesthetic, historical document styling | Historical, heritage, biography | -| `watercolor` | Soft hand-painted textures, natural warmth | Lifestyle, wellness, travel | +| Option | Description | +|--------|-------------| +| `--style ` | Visual style: preset name or `custom` | +| `--audience ` | Target: beginners, intermediate, experts, executives, general | +| `--lang ` | Output language (en, zh, ja, etc.) | +| `--slides ` | Target slide count (8-25 recommended, max 30) | +| `--outline-only` | Generate outline only, skip images | +| `--prompts-only` | Generate outline + prompts, skip images | +| `--images-only` | Generate images from existing prompts | +| `--regenerate ` | Regenerate specific slide(s): `3` or `2,5,8` | + +**Style System**: + +Styles are built from 4 dimensions: **Texture** × **Mood** × **Typography** × **Density** + +| Dimension | Options | +|-----------|---------| +| Texture | clean, grid, organic, pixel, paper | +| Mood | professional, warm, cool, vibrant, dark, neutral | +| Typography | geometric, humanist, handwritten, editorial, technical | +| Density | minimal, balanced, dense | + +**Presets** (pre-configured dimension combinations): + +| Preset | Dimensions | Best For | +|--------|------------|----------| +| `blueprint` (default) | grid + cool + technical + balanced | Architecture, system design | +| `chalkboard` | organic + warm + handwritten + balanced | Education, tutorials | +| `corporate` | clean + professional + geometric + balanced | Investor decks, proposals | +| `minimal` | clean + neutral + geometric + minimal | Executive briefings | +| `sketch-notes` | organic + warm + handwritten + balanced | Educational, tutorials | +| `watercolor` | organic + warm + humanist + minimal | Lifestyle, wellness | +| `dark-atmospheric` | clean + dark + editorial + balanced | Entertainment, gaming | +| `notion` | clean + neutral + geometric + dense | Product demos, SaaS | +| `bold-editorial` | clean + vibrant + editorial + balanced | Product launches, keynotes | +| `editorial-infographic` | clean + cool + editorial + dense | Tech explainers, research | +| `fantasy-animation` | organic + vibrant + handwritten + minimal | Educational storytelling | +| `intuition-machine` | clean + cool + technical + dense | Technical docs, academic | +| `pixel-art` | pixel + vibrant + technical + balanced | Gaming, developer talks | +| `scientific` | clean + cool + technical + dense | Biology, chemistry, medical | +| `vector-illustration` | clean + vibrant + humanist + balanced | Creative, children's content | +| `vintage` | paper + warm + editorial + balanced | Historical, heritage | **Style Previews**: @@ -341,7 +369,7 @@ Generate professional slide deck images from content. Creates comprehensive outl | ![watercolor](./screenshots/slide-deck-styles/watercolor.webp) | | | | watercolor | | | -After generation, slides are automatically merged into a `.pptx` file for easy sharing. +After generation, slides are automatically merged into `.pptx` and `.pdf` files for easy sharing. #### baoyu-comic diff --git a/README.zh.md b/README.zh.md index 2d79109..341db70 100644 --- a/README.zh.md +++ b/README.zh.md @@ -297,6 +297,9 @@ npx skills add jimliu/baoyu-skills /baoyu-slide-deck path/to/article.md --style corporate /baoyu-slide-deck path/to/article.md --audience executives +# 指定页数 +/baoyu-slide-deck path/to/article.md --slides 15 + # 仅生成大纲(不生成图片) /baoyu-slide-deck path/to/article.md --outline-only @@ -304,25 +307,50 @@ npx skills add jimliu/baoyu-skills /baoyu-slide-deck path/to/article.md --lang zh ``` -**风格**(视觉美学): +**选项**: -| 风格 | 描述 | 适用场景 | -|------|------|----------| -| `blueprint`(默认) | 技术蓝图风格,网格纹理,工程精度 | 架构设计、系统设计 | -| `notion` | SaaS 仪表盘美学,卡片式布局,数据清晰 | 产品演示、SaaS、B2B | -| `bold-editorial` | 杂志社论风格,粗体排版,深色背景 | 产品发布、主题演讲 | -| `corporate` | 海军蓝/金色配色,结构化布局,专业图标 | 投资者演示、客户提案 | -| `dark-atmospheric` | 电影级暗色调,发光效果,氛围感 | 娱乐、游戏、创意 | -| `editorial-infographic` | 杂志风格信息图,扁平插画 | 科技解说、研究报告 | -| `fantasy-animation` | 吉卜力/迪士尼风格,手绘动画 | 教育、故事讲述 | -| `intuition-machine` | 技术简报,双语标签,做旧纸张纹理 | 技术文档、双语内容 | -| `minimal` | 极简风格,大量留白,单一强调色 | 高管简报、高端品牌 | -| `pixel-art` | 复古 8-bit 像素风,怀旧游戏感 | 游戏、开发者分享 | -| `scientific` | 学术图表,生物通路,精确标注 | 生物、化学、医学 | -| `sketch-notes` | 手绘风格,柔和笔触,暖白色背景 | 教育、教程、知识分享 | -| `vector-illustration` | 扁平矢量风格,黑色轮廓线,复古柔和配色 | 创意提案、说明性内容 | -| `vintage` | 做旧纸张美学,历史文档风格 | 历史、传记、人文 | -| `watercolor` | 柔和手绘水彩纹理,自然温暖 | 生活方式、健康、旅行 | +| 选项 | 说明 | +|------|------| +| `--style ` | 视觉风格:预设名称或 `custom` | +| `--audience ` | 目标受众:beginners、intermediate、experts、executives、general | +| `--lang ` | 输出语言(en、zh、ja 等) | +| `--slides ` | 目标页数(推荐 8-25,最多 30) | +| `--outline-only` | 仅生成大纲,跳过图片 | +| `--prompts-only` | 生成大纲 + 提示词,跳过图片 | +| `--images-only` | 从现有提示词生成图片 | +| `--regenerate ` | 重新生成指定页:`3` 或 `2,5,8` | + +**风格系统**: + +风格由 4 个维度组合而成:**纹理** × **氛围** × **字体** × **密度** + +| 维度 | 选项 | +|------|------| +| 纹理 | clean 纯净、grid 网格、organic 有机、pixel 像素、paper 纸张 | +| 氛围 | professional 专业、warm 温暖、cool 冷静、vibrant 鲜艳、dark 暗色、neutral 中性 | +| 字体 | geometric 几何、humanist 人文、handwritten 手写、editorial 编辑、technical 技术 | +| 密度 | minimal 极简、balanced 均衡、dense 密集 | + +**预设**(预配置的维度组合): + +| 预设 | 维度组合 | 适用场景 | +|------|----------|----------| +| `blueprint`(默认) | grid + cool + technical + balanced | 架构设计、系统设计 | +| `chalkboard` | organic + warm + handwritten + balanced | 教育、教程 | +| `corporate` | clean + professional + geometric + balanced | 投资者演示、提案 | +| `minimal` | clean + neutral + geometric + minimal | 高管简报 | +| `sketch-notes` | organic + warm + handwritten + balanced | 教育、教程 | +| `watercolor` | organic + warm + humanist + minimal | 生活方式、健康 | +| `dark-atmospheric` | clean + dark + editorial + balanced | 娱乐、游戏 | +| `notion` | clean + neutral + geometric + dense | 产品演示、SaaS | +| `bold-editorial` | clean + vibrant + editorial + balanced | 产品发布、主题演讲 | +| `editorial-infographic` | clean + cool + editorial + dense | 科技解说、研究 | +| `fantasy-animation` | organic + vibrant + handwritten + minimal | 教育故事 | +| `intuition-machine` | clean + cool + technical + dense | 技术文档、学术 | +| `pixel-art` | pixel + vibrant + technical + balanced | 游戏、开发者 | +| `scientific` | clean + cool + technical + dense | 生物、化学、医学 | +| `vector-illustration` | clean + vibrant + humanist + balanced | 创意、儿童内容 | +| `vintage` | paper + warm + editorial + balanced | 历史、传记 | **风格预览**: @@ -341,7 +369,7 @@ npx skills add jimliu/baoyu-skills | ![watercolor](./screenshots/slide-deck-styles/watercolor.webp) | | | | watercolor | | | -生成完成后,所有幻灯片会自动合并为 `.pptx` 文件,方便分享。 +生成完成后,所有幻灯片会自动合并为 `.pptx` 和 `.pdf` 文件,方便分享。 #### baoyu-comic diff --git a/skills/baoyu-slide-deck/SKILL.md b/skills/baoyu-slide-deck/SKILL.md index 3abf630..752f360 100644 --- a/skills/baoyu-slide-deck/SKILL.md +++ b/skills/baoyu-slide-deck/SKILL.md @@ -1,11 +1,11 @@ --- name: baoyu-slide-deck -description: Generate professional slide deck images from content. Creates comprehensive outlines with style instructions, then generates individual slide images. Use when user asks to "create slides", "make a presentation", "generate deck", or "slide deck". +description: Generates professional slide deck images from content. Creates outlines with style instructions, then generates individual slide images. Use when user asks to "create slides", "make a presentation", "generate deck", "slide deck", or "PPT". --- # Slide Deck Generator -Transform content into professional slide deck images with flexible style options. +Transform content into professional slide deck images. ## Usage @@ -21,14 +21,10 @@ Transform content into professional slide deck images with flexible style option ## Script Directory -**Important**: All scripts are located in the `scripts/` subdirectory of this skill. - **Agent Execution Instructions**: 1. Determine this SKILL.md file's directory path as `SKILL_DIR` 2. Script path = `${SKILL_DIR}/scripts/.ts` -3. Replace all `${SKILL_DIR}` in this document with the actual path -**Script Reference**: | Script | Purpose | |--------|---------| | `scripts/merge-to-pptx.ts` | Merge slides into PowerPoint | @@ -38,339 +34,104 @@ Transform content into professional slide deck images with flexible style option | Option | Description | |--------|-------------| -| `--style ` | Visual style (see Style Gallery) | -| `--audience ` | Target audience: beginners, intermediate, experts, executives, general | +| `--style ` | Visual style: preset name, `custom`, or custom style name | +| `--audience ` | Target: beginners, intermediate, experts, executives, general | | `--lang ` | Output language (en, zh, ja, etc.) | -| `--slides ` | Target slide count (recommended: 8-25, max: 30) | +| `--slides ` | Target slide count (8-25 recommended, max 30) | | `--outline-only` | Generate outline only, skip image generation | +| `--prompts-only` | Generate outline + prompts, skip images | +| `--images-only` | Generate images from existing prompts directory | +| `--regenerate ` | Regenerate specific slide(s): `--regenerate 3` or `--regenerate 2,5,8` | -**Slide Count Guidance**: -| Content Length | Recommended Slides | -|----------------|-------------------| -| Short (< 1000 words) | 5-10 | -| Medium (1000-3000 words) | 10-18 | -| Long (3000-5000 words) | 15-25 | -| Very Long (> 5000 words) | 20-30 (consider splitting) | +**Slide Count by Content Length**: +| Content | Slides | +|---------|--------| +| < 1000 words | 5-10 | +| 1000-3000 words | 10-18 | +| 3000-5000 words | 15-25 | +| > 5000 words | 20-30 (consider splitting) | -Maximum 30 slides per deck. For longer content, split into multiple decks. +## Style System -## Audience Guidelines +### Presets -Design decisions should adapt to target audience. Use `--audience` to set. +| Preset | Dimensions | Best For | +|--------|------------|----------| +| `blueprint` (Default) | grid + cool + technical + balanced | Architecture, system design | +| `chalkboard` | organic + warm + handwritten + balanced | Education, tutorials | +| `corporate` | clean + professional + geometric + balanced | Investor decks, proposals | +| `minimal` | clean + neutral + geometric + minimal | Executive briefings | +| `sketch-notes` | organic + warm + handwritten + balanced | Educational, tutorials | +| `watercolor` | organic + warm + humanist + minimal | Lifestyle, wellness | +| `dark-atmospheric` | clean + dark + editorial + balanced | Entertainment, gaming | +| `notion` | clean + neutral + geometric + dense | Product demos, SaaS | +| `bold-editorial` | clean + vibrant + editorial + balanced | Product launches, keynotes | +| `editorial-infographic` | clean + cool + editorial + dense | Tech explainers, research | +| `fantasy-animation` | organic + vibrant + handwritten + minimal | Educational storytelling | +| `intuition-machine` | clean + cool + technical + dense | Technical docs, academic | +| `pixel-art` | pixel + vibrant + technical + balanced | Gaming, developer talks | +| `scientific` | clean + cool + technical + dense | Biology, chemistry, medical | +| `vector-illustration` | clean + vibrant + humanist + balanced | Creative, children's content | +| `vintage` | paper + warm + editorial + balanced | Historical, heritage | -| Audience | Content Density | Visual Style | Terminology | Slides | -|----------|-----------------|--------------|-------------|--------| -| `beginners` | Low | Friendly, illustrative | Plain language | 8-15 | -| `intermediate` | Medium | Balanced, structured | Some jargon OK | 10-20 | -| `experts` | High | Data-rich, precise | Technical terms | 12-25 | -| `executives` | Medium-High | Clean, impactful | Business language | 8-12 | -| `general` | Medium | Accessible, engaging | Minimal jargon | 10-18 | +### Style Dimensions -### Audience-Specific Principles +| Dimension | Options | Description | +|-----------|---------|-------------| +| **Texture** | clean, grid, organic, pixel, paper | Visual texture and background treatment | +| **Mood** | professional, warm, cool, vibrant, dark, neutral | Color temperature and palette style | +| **Typography** | geometric, humanist, handwritten, editorial, technical | Headline and body text styling | +| **Density** | minimal, balanced, dense | Information density per slide | -**Beginners**: -- One concept per slide -- Visual metaphors over abstract diagrams -- Step-by-step progression -- Generous whitespace +Full specs: `references/dimensions/*.md` -**Experts**: -- Multiple data points per slide acceptable -- Technical diagrams with precise labels -- Assume domain knowledge -- Dense but organized information +### Auto Style Selection -**Executives**: -- Lead with insights, not data -- "So what?" on every slide -- Decision-enabling content -- Bottom-line upfront (BLUF) - -## Style Gallery - -### Style Selection Principles - -**Content-First Approach**: -1. Analyze content topic, mood, and industry before selecting -2. Consider target audience expectations -3. Match style to subject matter (not personal preference) - -**Quick Reference by Content Type**: -| Content Type | Recommended Styles | -|--------------|-------------------| -| Technical/Architecture | `blueprint`, `intuition-machine` | -| Educational/Tutorials | `sketch-notes`, `chalkboard` | -| Corporate/Business | `corporate`, `minimal` | -| Creative/Artistic | `vector-illustration`, `watercolor` | -| Product/SaaS | `notion`, `bold-editorial` | -| Scientific/Research | `scientific`, `editorial-infographic` | - -**Note**: Full style specifications in `references/styles/