diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 02f73ee..cc8867e 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.15.3" + "version": "1.16.0" }, "plugins": [ { diff --git a/CHANGELOG.md b/CHANGELOG.md index 2d31060..b96183b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,18 @@ English | [中文](./CHANGELOG.zh.md) +## 1.16.0 - 2026-01-23 + +### Features +- `baoyu-article-illustrator`: adds user preferences support via EXTEND.md—configure watermark (content, position, opacity), preferred type/style, and custom styles. New Step 1.1 checks for preferences at project (`.baoyu-skills/`) or user (`~/.baoyu-skills/`) level with first-time setup flow. + +### Refactor +- `baoyu-article-illustrator`: restructures to Type × Style two-dimension system—replaces 20+ single-dimension styles with modular Type (infographic, scene, flowchart, comparison, framework, timeline) × Style (notion, elegant, warm, minimal, blueprint, watercolor, editorial, scientific) architecture. Adds `--type` and `--density` options, Type × Style compatibility matrix, and structured prompt construction templates. + +### Documentation +- `baoyu-article-illustrator`: adds three reference documents—`references/styles.md` (style gallery and compatibility matrix), `references/config/preferences-schema.md` (EXTEND.md YAML schema), `references/config/first-time-setup.md` (setup flow). +- `README.md`, `README.zh.md`: updates baoyu-article-illustrator documentation to reflect new Type × Style system with `--type` and `--style` options. + ## 1.15.3 - 2026-01-23 ### Refactor diff --git a/CHANGELOG.zh.md b/CHANGELOG.zh.md index 77bda2b..9a98191 100644 --- a/CHANGELOG.zh.md +++ b/CHANGELOG.zh.md @@ -2,6 +2,18 @@ [English](./CHANGELOG.md) | 中文 +## 1.16.0 - 2026-01-23 + +### 新功能 +- `baoyu-article-illustrator`:新增用户偏好设置支持(通过 EXTEND.md 配置)——可设置水印(内容、位置、透明度)、首选类型/风格和自定义风格。新增 Step 1.1 检查项目级(`.baoyu-skills/`)或用户级(`~/.baoyu-skills/`)偏好设置,首次使用时引导设置。 + +### 重构 +- `baoyu-article-illustrator`:重构为类型 × 风格二维系统——将 20+ 种单维风格替换为模块化的类型(infographic 信息图、scene 场景、flowchart 流程图、comparison 对比、framework 框架、timeline 时间线)× 风格(notion、elegant、warm、minimal、blueprint、watercolor、editorial、scientific)架构。新增 `--type` 和 `--density` 选项、类型 × 风格兼容性矩阵,以及结构化提示词构建模板。 + +### 文档 +- `baoyu-article-illustrator`:新增三个参考文档——`references/styles.md`(风格库和兼容性矩阵)、`references/config/preferences-schema.md`(EXTEND.md YAML 配置模式)、`references/config/first-time-setup.md`(首次设置流程)。 +- `README.md`、`README.zh.md`:更新 baoyu-article-illustrator 文档,反映新的类型 × 风格系统及 `--type` 和 `--style` 选项。 + ## 1.15.3 - 2026-01-23 ### 重构 diff --git a/README.md b/README.md index c13ec11..f75f340 100644 --- a/README.md +++ b/README.md @@ -426,42 +426,45 @@ Knowledge comic creator with flexible art style × tone combinations. Creates or #### baoyu-article-illustrator -Smart article illustration skill. Analyzes article content and generates illustrations at positions requiring visual aids. +Smart article illustration skill with Type × Style two-dimension approach. Analyzes article structure, identifies positions requiring visual aids, and generates illustrations. ```bash -# Auto-select style based on content +# Auto-select type and style based on content /baoyu-article-illustrator path/to/article.md -# Specify a style -/baoyu-article-illustrator path/to/article.md --style warm -/baoyu-article-illustrator path/to/article.md --style watercolor +# Specify type +/baoyu-article-illustrator path/to/article.md --type infographic + +# Specify style +/baoyu-article-illustrator path/to/article.md --style blueprint + +# Combine type and style +/baoyu-article-illustrator path/to/article.md --type flowchart --style notion ``` +**Types** (information structure): + +| Type | Description | Best For | +|------|-------------|----------| +| `infographic` | Data visualization, charts, metrics | Technical articles, data analysis | +| `scene` | Atmospheric illustration, mood rendering | Narrative, personal stories | +| `flowchart` | Process diagrams, step visualization | Tutorials, workflows | +| `comparison` | Side-by-side, before/after contrast | Product comparisons | +| `framework` | Concept maps, relationship diagrams | Methodologies, architecture | +| `timeline` | Chronological progression | History, project progress | + **Styles** (visual aesthetics): | Style | Description | Best For | |-------|-------------|----------| | `notion` (default) | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity | -| `elegant` | Refined, sophisticated, professional | Business, thought leadership | -| `warm` | Friendly, approachable, human-centered | Personal growth, lifestyle | -| `minimal` | Ultra-clean, zen-like, focused | Philosophy, minimalism | -| `playful` | Fun, creative, whimsical | Tutorials, beginner guides | -| `nature` | Organic, calm, earthy | Sustainability, wellness | -| `sketch` | Raw, authentic, notebook-style | Ideas, brainstorming | +| `elegant` | Refined, sophisticated | Business, thought leadership | +| `warm` | Friendly, approachable | Personal growth, lifestyle | +| `minimal` | Ultra-clean, zen-like | Philosophy, minimalism | +| `blueprint` | Technical schematics | Architecture, system design | | `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative | -| `vintage` | Nostalgic aged-paper aesthetic | Historical, biography | -| `scientific` | Academic precise diagrams | Biology, chemistry, technical | -| `chalkboard` | Classroom chalk drawing style | Education, tutorials | | `editorial` | Magazine-style infographic | Tech explainers, journalism | -| `flat` | Modern flat vector illustration | Startups, digital | -| `flat-doodle` | Bold outlines, pastel colors, cute | Productivity, SaaS, workflows | -| `retro` | 80s/90s vibrant nostalgic | Pop culture, entertainment | -| `blueprint` | Technical schematics, engineering | Architecture, system design | -| `vector-illustration` | Flat vector, black outlines, retro | Educational, creative, brand | -| `sketch-notes` | Soft hand-drawn, warm feel | Knowledge sharing, tutorials | -| `pixel-art` | Retro 8-bit gaming aesthetic | Gaming, tech, developer | -| `intuition-machine` | Technical briefing, bilingual | Academic, technical, research | -| `fantasy-animation` | Ghibli/Disney whimsical style | Storytelling, children's | +| `scientific` | Academic precise diagrams | Biology, chemistry, technical | **Style Previews**: @@ -469,18 +472,10 @@ Smart article illustration skill. Analyzes article content and generates illustr |:---:|:---:|:---:| | ![notion](./screenshots/article-illustrator-styles/notion.webp) | ![elegant](./screenshots/article-illustrator-styles/elegant.webp) | ![warm](./screenshots/article-illustrator-styles/warm.webp) | | notion | elegant | warm | -| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![playful](./screenshots/article-illustrator-styles/playful.webp) | ![nature](./screenshots/article-illustrator-styles/nature.webp) | -| minimal | playful | nature | -| ![sketch](./screenshots/article-illustrator-styles/sketch.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) | ![vintage](./screenshots/article-illustrator-styles/vintage.webp) | -| sketch | watercolor | vintage | -| ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | ![chalkboard](./screenshots/article-illustrator-styles/chalkboard.webp) | ![editorial](./screenshots/article-illustrator-styles/editorial.webp) | -| scientific | chalkboard | editorial | -| ![flat](./screenshots/article-illustrator-styles/flat.webp) | ![retro](./screenshots/article-illustrator-styles/retro.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) | -| flat | retro | blueprint | -| ![vector-illustration](./screenshots/article-illustrator-styles/vector-illustration.webp) | ![sketch-notes](./screenshots/article-illustrator-styles/sketch-notes.webp) | ![pixel-art](./screenshots/article-illustrator-styles/pixel-art.webp) | -| vector-illustration | sketch-notes | pixel-art | -| ![intuition-machine](./screenshots/article-illustrator-styles/intuition-machine.webp) | ![fantasy-animation](./screenshots/article-illustrator-styles/fantasy-animation.webp) | ![flat-doodle](./screenshots/article-illustrator-styles/flat-doodle.webp) | -| intuition-machine | fantasy-animation | flat-doodle | +| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) | +| minimal | blueprint | watercolor | +| ![editorial](./screenshots/article-illustrator-styles/editorial.webp) | ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | | +| editorial | scientific | | #### baoyu-post-to-x diff --git a/README.zh.md b/README.zh.md index e6a9bfb..c50bf8e 100644 --- a/README.zh.md +++ b/README.zh.md @@ -426,42 +426,45 @@ npx skills add jimliu/baoyu-skills #### baoyu-article-illustrator -智能文章插图技能。分析文章内容,在需要视觉辅助的位置生成插图。 +智能文章插图技能,采用类型 × 风格二维系统。分析文章结构,识别需要视觉辅助的位置,生成插图。 ```bash -# 根据内容自动选择风格 +# 根据内容自动选择类型和风格 /baoyu-article-illustrator path/to/article.md +# 指定类型 +/baoyu-article-illustrator path/to/article.md --type infographic + # 指定风格 -/baoyu-article-illustrator path/to/article.md --style warm -/baoyu-article-illustrator path/to/article.md --style watercolor +/baoyu-article-illustrator path/to/article.md --style blueprint + +# 组合类型和风格 +/baoyu-article-illustrator path/to/article.md --type flowchart --style notion ``` +**类型**(信息结构): + +| 类型 | 描述 | 适用场景 | +|------|------|----------| +| `infographic` | 数据可视化、图表、指标 | 技术文章、数据分析 | +| `scene` | 氛围插图、情绪渲染 | 叙事、个人故事 | +| `flowchart` | 流程图、步骤可视化 | 教程、工作流 | +| `comparison` | 并排对比、前后对照 | 产品比较 | +| `framework` | 概念图、关系图 | 方法论、架构 | +| `timeline` | 时间线进展 | 历史、项目进度 | + **风格**(视觉美学): | 风格 | 描述 | 适用场景 | |------|------|----------| | `notion`(默认) | 极简手绘线条画 | 知识分享、SaaS、生产力 | -| `elegant` | 精致、优雅、专业 | 商业、思想领导力 | -| `warm` | 友好、亲切、人文关怀 | 个人成长、生活方式 | -| `minimal` | 极简、禅意、专注 | 哲学、极简主义 | -| `playful` | 有趣、创意、俏皮 | 教程、新手指南 | -| `nature` | 自然、平静、质朴 | 可持续发展、健康 | -| `sketch` | 原始、真实、笔记风格 | 想法、头脑风暴 | +| `elegant` | 精致、优雅 | 商业、思想领导力 | +| `warm` | 友好、亲切 | 个人成长、生活方式 | +| `minimal` | 极简、禅意 | 哲学、极简主义 | +| `blueprint` | 技术蓝图 | 架构、系统设计 | | `watercolor` | 柔和艺术感、自然温暖 | 生活方式、旅行、创意 | -| `vintage` | 怀旧做旧纸张美学 | 历史、传记 | -| `scientific` | 学术精确图表 | 生物、化学、技术 | -| `chalkboard` | 教室粉笔画风格 | 教育、教程 | | `editorial` | 杂志风格信息图 | 科技解说、新闻 | -| `flat` | 现代扁平矢量插画 | 创业公司、数字化 | -| `flat-doodle` | 粗轮廓、粉彩色、可爱风 | 生产力、SaaS、工作流 | -| `retro` | 80/90 年代复古鲜艳 | 流行文化、娱乐 | -| `blueprint` | 技术蓝图、工程精度 | 架构、系统设计 | -| `vector-illustration` | 扁平矢量、黑色轮廓、复古 | 教育、创意、品牌 | -| `sketch-notes` | 柔和手绘、温暖感 | 知识分享、教程 | -| `pixel-art` | 复古 8-bit 游戏风格 | 游戏、技术、开发者 | -| `intuition-machine` | 技术简报、双语标签 | 学术、技术、研究 | -| `fantasy-animation` | 吉卜力/迪士尼童话风格 | 故事、儿童、创意 | +| `scientific` | 学术精确图表 | 生物、化学、技术 | **风格预览**: @@ -469,18 +472,10 @@ npx skills add jimliu/baoyu-skills |:---:|:---:|:---:| | ![notion](./screenshots/article-illustrator-styles/notion.webp) | ![elegant](./screenshots/article-illustrator-styles/elegant.webp) | ![warm](./screenshots/article-illustrator-styles/warm.webp) | | notion | elegant | warm | -| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![playful](./screenshots/article-illustrator-styles/playful.webp) | ![nature](./screenshots/article-illustrator-styles/nature.webp) | -| minimal | playful | nature | -| ![sketch](./screenshots/article-illustrator-styles/sketch.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) | ![vintage](./screenshots/article-illustrator-styles/vintage.webp) | -| sketch | watercolor | vintage | -| ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | ![chalkboard](./screenshots/article-illustrator-styles/chalkboard.webp) | ![editorial](./screenshots/article-illustrator-styles/editorial.webp) | -| scientific | chalkboard | editorial | -| ![flat](./screenshots/article-illustrator-styles/flat.webp) | ![retro](./screenshots/article-illustrator-styles/retro.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) | -| flat | retro | blueprint | -| ![vector-illustration](./screenshots/article-illustrator-styles/vector-illustration.webp) | ![sketch-notes](./screenshots/article-illustrator-styles/sketch-notes.webp) | ![pixel-art](./screenshots/article-illustrator-styles/pixel-art.webp) | -| vector-illustration | sketch-notes | pixel-art | -| ![intuition-machine](./screenshots/article-illustrator-styles/intuition-machine.webp) | ![fantasy-animation](./screenshots/article-illustrator-styles/fantasy-animation.webp) | ![flat-doodle](./screenshots/article-illustrator-styles/flat-doodle.webp) | -| intuition-machine | fantasy-animation | flat-doodle | +| ![minimal](./screenshots/article-illustrator-styles/minimal.webp) | ![blueprint](./screenshots/article-illustrator-styles/blueprint.webp) | ![watercolor](./screenshots/article-illustrator-styles/watercolor.webp) | +| minimal | blueprint | watercolor | +| ![editorial](./screenshots/article-illustrator-styles/editorial.webp) | ![scientific](./screenshots/article-illustrator-styles/scientific.webp) | | +| editorial | scientific | | #### baoyu-post-to-x diff --git a/skills/baoyu-article-illustrator/SKILL.md b/skills/baoyu-article-illustrator/SKILL.md index fd77c76..41662d7 100644 --- a/skills/baoyu-article-illustrator/SKILL.md +++ b/skills/baoyu-article-illustrator/SKILL.md @@ -1,376 +1,452 @@ --- name: baoyu-article-illustrator -description: Smart article illustration skill. Analyzes article content and generates illustrations at positions requiring visual aids with multiple style options. Use when user asks to "add illustrations to article", "generate images for article", or "illustrate article". +description: Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style two-dimension approach. Use when user asks to "illustrate article", "add images", "generate images for article", or "为文章配图". --- -# Smart Article Illustration Skill +# Article Illustrator -Analyze article structure and content, identify positions requiring visual aids, and generate illustrations with flexible style options. +Analyze articles, identify illustration positions, generate images with Type × Style consistency. ## Usage ```bash -# Auto-select style based on content +# Auto-select type and style based on content /baoyu-article-illustrator path/to/article.md -# Specify a style -/baoyu-article-illustrator path/to/article.md --style warm -/baoyu-article-illustrator path/to/article.md --style minimal -/baoyu-article-illustrator path/to/article.md --style watercolor +# Specify type +/baoyu-article-illustrator path/to/article.md --type infographic -# Combine with other options -/baoyu-article-illustrator path/to/article.md --style playful +# Specify style +/baoyu-article-illustrator path/to/article.md --style blueprint + +# Combine type and style +/baoyu-article-illustrator path/to/article.md --type flowchart --style notion + +# Specify density +/baoyu-article-illustrator path/to/article.md --density rich + +# Direct content input +/baoyu-article-illustrator +[paste content] ``` ## Options | Option | Description | |--------|-------------| -| `--style ` | Specify illustration style (see Style Gallery below) | +| `--type ` | Illustration type (see Type Gallery) | +| `--style ` | Visual style (see Style Gallery) | +| `--density ` | Image count: minimal / balanced / rich | + +## Two Dimensions + +| Dimension | Controls | Examples | +|-----------|----------|----------| +| **Type** | Information structure, content layout | infographic, scene, flowchart, comparison, framework, timeline | +| **Style** | Visual aesthetics, colors, mood | notion, warm, minimal, blueprint, watercolor, elegant | + +Type × Style can be freely combined. Example: `--type infographic --style blueprint` creates technical data visualization with schematic aesthetics. + +## Type Gallery + +| Type | Description | Best For | +|------|-------------|----------| +| `infographic` | Data visualization, charts, metrics | Technical articles, data analysis, comparisons | +| `scene` | Atmospheric illustration, mood rendering | Narrative articles, personal stories, emotional content | +| `flowchart` | Process diagrams, step visualization | Tutorials, workflows, decision trees | +| `comparison` | Side-by-side, before/after contrast | Product comparisons, option evaluations | +| `framework` | Concept maps, relationship diagrams | Methodologies, models, architecture design | +| `timeline` | Chronological progression | History, project progress, evolution | + +## Density Options + +| Density | Count | Description | +|---------|-------|-------------| +| `minimal` | 1-2 | Core concepts only | +| `balanced` (Default) | 3-5 | Major sections coverage | +| `rich` | 6+ | Rich visual support | ## Style Gallery | Style | Description | Best For | |-------|-------------|----------| -| `notion` (Default) | Minimalist hand-drawn line art, intellectual | Knowledge sharing, SaaS, productivity | -| `elegant` | Refined, sophisticated, professional | Business, thought leadership | -| `warm` | Friendly, approachable, human-centered | Personal growth, lifestyle, education | -| `minimal` | Ultra-clean, zen-like, focused | Philosophy, minimalism, core concepts | -| `playful` | Fun, creative, whimsical | Tutorials, beginner guides, fun topics | -| `nature` | Organic, calm, earthy | Sustainability, wellness, outdoor | -| `sketch` | Raw, authentic, notebook-style | Ideas, brainstorming, drafts | +| `notion` (Default) | Minimalist hand-drawn line art | Knowledge sharing, SaaS, productivity | +| `elegant` | Refined, sophisticated | Business, thought leadership | +| `warm` | Friendly, approachable | Personal growth, lifestyle, education | +| `minimal` | Ultra-clean, zen-like | Philosophy, minimalism, core concepts | +| `blueprint` | Technical schematics | Architecture, system design, engineering | | `watercolor` | Soft artistic with natural warmth | Lifestyle, travel, creative | -| `vintage` | Nostalgic aged-paper aesthetic | Historical, biography, heritage | -| `scientific` | Academic precise diagrams | Biology, chemistry, technical | -| `chalkboard` | Classroom chalk drawing style | Education, tutorials, workshops | | `editorial` | Magazine-style infographic | Tech explainers, journalism | -| `flat` | Modern flat vector illustration | Startups, digital, contemporary | -| `flat-doodle` | Bold outlines, pastel colors, cute | Productivity, SaaS, workflows | -| `retro` | 80s/90s vibrant nostalgic | Pop culture, gaming, entertainment | -| `blueprint` | Technical schematics, engineering precision | Architecture, system design | -| `vector-illustration` | Flat vector with black outlines, retro colors | Educational, creative, brand content | -| `sketch-notes` | Soft hand-drawn, warm educational feel | Knowledge sharing, tutorials | -| `pixel-art` | Retro 8-bit gaming aesthetic | Gaming, tech, developer content | -| `intuition-machine` | Technical briefing with bilingual labels | Academic, technical, bilingual | -| `fantasy-animation` | Ghibli/Disney whimsical style | Storytelling, children's, creative | +| `scientific` | Academic precise diagrams | Biology, chemistry, technical research | -Full style specifications in `references/styles/