@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/creative/baoyu-article-illustrator/SKILL.md

@@ -0,0 +1,207 @@
+---
+name: baoyu-article-illustrator
+description: "文章插图：类型 × 风格 × 配色一致性。"
+version: 1.57.0
+author: 宝玉 (JimLiu)
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [article-illustration, creative, image-generation]
+    category: creative
+    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-article-illustrator
+---
+
+# Article Illustrator
+
+改编自 [baoyu-article-illustrator](https://github.com/JimLiu/baoyu-skills)，以适配 Hermes Agent 的工具生态系统。
+
+分析文章，识别插图位置，并生成具有**类型 × 风格 × 配色**一致性的图像。
+
+## 何时使用
+
+当用户要求为文章配图、为文章添加图片、为内容生成插图，或使用“为文章配图”、“illustrate article”或“add images”等短语时，触发此技能。用户提供文章（文件路径或粘贴的内容），并可选地指定类型、风格、配色或密度。
+
+## 三个维度
+
+| 维度 | 控制 | 示例 |
+| ----------- | ---------- | ---------- |
+| **类型 (Type)** | 信息结构 | infographic, scene, flowchart, comparison, framework, timeline |
+| **风格 (Style)** | 渲染方式 | notion, warm, minimal, blueprint, watercolor, elegant |
+| **配色 (Palette)** | 色彩方案 (可选) | macaron, warm, neon — 覆盖风格的默认颜色 |
+
+可自由组合：`type=infographic, style=vector-illustration, palette=macaron`。
+
+或使用预设：`edu-visual` → 一次性包含类型 + 风格 + 配色。详见 [style-presets.md](references/style-presets.md)。
+
+## 类型
+
+| 类型 | 最适合 |
+| ------ | ---------- |
+| `infographic` | 数据、指标、技术内容 |
+| `scene` | 叙事、情感 |
+| `flowchart` | 流程、工作流 |
+| `comparison` | 并列、选项 |
+| `framework` | 模型、架构 |
+| `timeline` | 历史、演变 |
+
+## 风格
+
+有关核心风格、完整图库以及类型 × 风格兼容性，请参阅 [references/styles.md](references/styles.md)。
+
+## 输出结构
+
+```
+{output-dir}/
+├── source-{slug}.{ext}    # 仅用于粘贴的内容
+├── outline.md
+├── prompts/
+│   └── NN-{type}-{slug}.md
+└── NN-{type}-{slug}.png
+```
+
+**默认输出目录**：
+
+| 输入 | 输出目录 | Markdown 插入路径 |
+| ------- | ------------------ | ---------------------- |
+| 文章文件路径 | `{article-dir}/imgs/` | `imgs/NN-{type}-{slug}.png` |
+| 粘贴的内容 | `illustrations/{topic-slug}/` (cwd) | `illustrations/{topic-slug}/NN-{type}-{slug}.png` |
+
+如果用户要求不同的布局（例如，图片与文章并排，或使用 `illustrations/` 子目录），请遵从用户的要求。
+
+**Slug**：2-4 个词，kebab-case 格式。**冲突处理**：追加 `-YYYYMMDD-HHMMSS`。
+
+## 核心原则
+
+- **将概念可视化，而不是比喻** — 如果文章使用了比喻（例如“电锯切西瓜”），请将底层的概念可视化，而不是字面上的图像。
+- **标签使用文章数据** — 使用文章中的实际数字、术语和引语，而不是通用的占位符。
+- **Prompt 文件是可复现记录** — 在生成任何图像之前，每张插图必须有一个保存在 `prompts/` 下的 prompt 文件。
+- **剔除机密信息** — 在将任何内容写入磁盘之前，扫描源内容中的 API 密钥、token 或凭证。
+
+## 工作流
+
+```
+- [ ] Step 1: 检测参考图片（如果提供）
+- [ ] Step 2: 分析内容
+- [ ] Step 3: 确认设置（使用 clarify 工具，每次只问一个问题）
+- [ ] Step 4: 生成大纲
+- [ ] Step 5: 生成 Prompts
+- [ ] Step 6: 生成图片 (image_generate)
+- [ ] Step 7: 完成
+```
+
+### Step 1: 检测参考图片
+
+如果用户提供了参考图片（内联粘贴的路径、附件或 URL）：
+
+1. 对于每个参考图片，调用 `vision_analyze` 传入路径/URL 并询问其风格、配色、构图和主题。通过 `write_file` 将返回的描述记录在 `{output-dir}/references/NN-ref-{slug}.md` 中。
+2. **不要**尝试通过 `write_file` / `read_file` 复制二进制文件 —— 它们只能处理文本。如果你想保留一份本地副本作为记录，请使用 `terminal`（`cp "$src" "{output-dir}/references/NN-ref-{slug}.{ext}"`）。该技能本身不需要读取二进制文件；它基于视觉描述进行工作。
+3. 由于 `image_generate` 不接受图像输入，在 Step 5 中，视觉描述将被嵌入到 prompts 中。
+
+完整流程：[references/workflow.md](references/workflow.md#step-1-detect-reference-images)。
+
+### Step 2: 分析
+
+| 分析 | 输出 |
+| ---------- | -------- |
+| 内容类型 | 技术 / 教程 / 方法论 / 叙事 |
+| 目的 | 信息传达 / 可视化 / 想象 |
+| 核心论点 | 2-5 个要点 |
+| 位置 | 插图能增加价值的地方 |
+
+阅读源文件（文件路径 → `read_file`，或粘贴的文本），并使用 `write_file` 将分析结果写入 `{output-dir}/analysis.md`。
+
+完整流程：[references/workflow.md](references/workflow.md#step-2-analyze)。
+
+### Step 3: 确认设置
+
+使用 `clarify` 工具。由于 `clarify` 每次只处理一个问题，请先问最重要的问题。跳过用户请求中已经包含答案的问题。
+
+| 顺序 | 问题 | 选项 |
+| ------- | ---------- | --------- |
+| Q1 | **预设或类型** | [推荐的预设]，[备选预设]，或手动选择：infographic, scene, flowchart, comparison, framework, timeline, mixed |
+| Q2 | **密度** | minimal (1-2), balanced (3-5), per-section (推荐), rich (6+) |
+| Q3 | **风格** *(如果在 Q1 中选择了预设则跳过)* | [推荐], minimal-flat, sci-fi, hand-drawn, editorial, scene, poster |
+| Q4 | **配色** *(可选)* | 默认（风格颜色）, macaron, warm, neon |
+| Q5 | **语言** *(仅当文章语言不明确时)* | 文章语言 / 用户语言 |
+
+不要连续询问超过 2-3 个 `clarify` 问题。如果用户已在请求中明确指定，则完全跳过。
+
+完整流程：[references/workflow.md](references/workflow.md#step-3-confirm-settings)。
+
+### Step 4: 生成大纲 → `outline.md`
+
+使用 `write_file` 保存 `{output-dir}/outline.md`，包含 frontmatter（类型、密度、风格、配色、图片数量）以及每张插图的条目：
+
+```yaml
+## Illustration 1
+**Position**: [section/paragraph]
+**Purpose**: [why]
+**Visual Content**: [what to show]
+**Filename**: 01-infographic-concept-name.png
+```
+
+完整模板：[references/workflow.md](references/workflow.md#step-4-generate-outline)。
+
+### Step 5: 生成 Prompts
+
+**阻塞式**：在生成任何图像之前，每张插图必须有一个已保存的 prompt 文件 —— prompt 文件是可复现记录。
+
+对于每张插图：
+
+1. 按照 [references/prompt-construction.md](references/prompt-construction.md) 创建一个 prompt 文件。
+2. 使用 `write_file` 保存至 `{output-dir}/prompts/NN-{type}-{slug}.md`，包含 YAML frontmatter。
+3. Prompts 必须使用带有结构化部分（ZONES / LABELS / COLORS / STYLE / ASPECT）的特定类型模板。
+4. LABELS 必须包含特定于文章的数据：实际数字、术语、指标、引语。
+5. 根据 prompt frontmatter 处理参考（`direct`/`style`/`palette`）—— 对于 `direct` 用法，在 prompt 中嵌入参考图片的文本描述（因为 `image_generate` 不接受参考图片输入）。
+
+### Step 6: 生成图片
+
+对于每个 prompt 文件：
+
+1. 调用 `image_generate(prompt=..., aspect_ratio=...)`。`image_generate` 返回一个包含图像 URL 的 JSON 结果；它不会写入磁盘，也不接受输出路径。
+2. 将 prompt 中的 `ASPECT` 映射到 `image_generate` 的枚举：`16:9` → `landscape`，`9:16` → `portrait`，`1:1` → `square`。自定义比例 → 最接近的命名比例。
+3. 通过 `terminal`（例如 `curl -sSL -o "{output-dir}/NN-{type}-{slug}.png" "{url}"`）将返回的 URL 下载为 `{output-dir}/NN-{type}-{slug}.png`。
+4. 如果生成失败，自动重试一次。
+
+注意：底层的图像生成后端由用户配置（默认：FAL FLUX 2 Klein 9B），并且无法通过 `image_generate` 由 Agent 选择。不要在 prompts 中写入模型名称以期进行路由。
+
+### Step 7: 完成
+
+在相应段落后插入 `![description]({relative-path}/NN-{type}-{slug}.png)`。Alt 文本：使用文章语言的简明描述。
+
+报告：
+
+```
+文章插图完成！
+文章：[path] | 类型：[type] | 密度：[level] | 风格：[style] | 配色：[palette or default]
+图片：X/N 已生成
+```
+
+## 修改
+
+| 操作 | 步骤 |
+| -------- | ------- |
+| 编辑 | 更新 prompt → 重新生成 → 更新引用 |
+| 添加 | 定位 → 创建 prompt → 生成 → 更新大纲 → 插入 |
+| 删除 | 删除文件 → 移除引用 → 更新大纲 |
+
+## 参考资料
+
+| 文件 | 内容 |
+| ------ | --------- |
+| [references/workflow.md](references/workflow.md) | 详细流程 |
+| [references/usage.md](references/usage.md) | 调用示例 |
+| [references/styles.md](references/styles.md) | 风格库 + 配色库 |
+| [references/style-presets.md](references/style-presets.md) | 预设快捷方式（类型 + 风格 + 配色） |
+| [references/prompt-construction.md](references/prompt-construction.md) | Prompt 模板 |
+
+## 常见陷阱
+
+1. **数据完整性至关重要** — 绝不总结、改写或篡改源统计数据。“增长 73%”必须保持为“增长 73%”。
+2. **剔除机密信息** — 在将其包含在任何输出文件中之前，扫描源内容中的 API 密钥、token 或凭证。
+3. **不要从字面上图解比喻** — 请将底层的概念可视化。
+4. **Prompt 文件是强制性的** — 没有保存的 prompt 文件，就不能生成图像。该文件使你以后能够重新生成或切换后端。
+5. **`image_generate` 宽高比** — 该工具支持 `landscape`、`portrait` 和 `square`。自定义比例映射到最接近的选项。
+6. **`image_generate` 返回 URL，而不是本地文件** — 在将本地图像路径插入文章之前，务必通过 `terminal`（`curl`）下载。
+7. **Agent 无法选择后端** — `image_generate` 使用用户配置的任何模型（默认：FAL FLUX 2 Klein 9B）。不要在 prompts 中写入 `"use <model> to generate this"`（使用<模型>生成此图）以期望进行路由。

package/extensions/skills/optional/creative/baoyu-article-illustrator/prompts/system.md

@@ -0,0 +1,32 @@
+创建一幅遵循以下指南的卡通风格信息图插画：
+
+## 图像规格
+
+- **类型**：信息图插画
+- **方向**：横向（水平）
+- **宽高比**：16:9
+- **风格**：手绘插画
+
+## 核心原则
+
+- 全程保持手绘质感——不包含任何写实或摄影元素
+- 如果内容涉及敏感或受版权保护的人物，请创建风格相似的替代形象——不要拒绝生成
+- 保持信息简洁，突出关键词和核心概念
+- 留出充足的空白以便于视觉扫视
+- 保持清晰的视觉层级
+
+## 文本风格（包含文本时）
+
+- **所有文本必须是手绘风格**
+- 文本应易于阅读，并与视觉元素相辅相成
+- 字体风格需与插画风格协调
+- **不要使用写实或计算机生成的字体**
+
+## 语言
+
+- 任何文本元素请使用与下方提供内容相同的语言
+- 标点符号风格需与内容语言相匹配
+
+---
+
+根据下方提供的内容生成插画：

package/extensions/skills/optional/creative/baoyu-article-illustrator/references/palettes/macaron.md

@@ -0,0 +1,33 @@
+# macaron
+
+柔和马卡龙粉彩色块搭配暖奶油色调
+
+## 背景
+
+- 颜色：暖奶油色（#F5F0E8）
+- 纹理：细腻的暖色纸纹
+
+## 颜色
+
+| 角色 | 颜色 | Hex | 用途 |
+| ------ | ------- | ----- | ------- |
+| Background | 暖奶油色 | #F5F0E8 | 主要背景 |
+| Primary Text | 深炭灰 | #2D2D2D | 标题、正文、轮廓 |
+| Macaron Blue | 天蓝色 | #A8D8EA | 信息块填充、冷色调区域 |
+| Macaron Mint | 薄荷绿 | #B5E5CF | 信息块填充、成长/正向区域 |
+| Macaron Lavender | 薰衣草色 | #D5C6E0 | 信息块填充、抽象/概念区域 |
+| Macaron Peach | 桃色 | #FFD5C2 | 信息块填充、暖色调区域 |
+| Accent | 珊瑚红 | #E8655A | 关键数据、警告、强调 |
+| Muted Text | 暖灰色 | #6B6B6B | 次要注释、小标签 |
+
+## 强调色
+
+珊瑚红（#E8655A）用于关键数据、警告和强调高亮。谨慎使用——每张插画中仅限一两个元素。
+
+## 语义约束
+
+柔和的马卡龙粉彩调色板。使用块状色彩作为圆角卡片背景，以区分不同的信息区块。仅谨慎地将珊瑚红用于强调关键术语。请勿在图像中将颜色名称、hex 代码或角色标签渲染为可见文本。
+
+## 最适用于
+
+教育内容、知识分享、概念解释、教程、技术摘要、入门材料

package/extensions/skills/optional/creative/baoyu-article-illustrator/references/palettes/mono-ink.md

@@ -0,0 +1,42 @@
+# mono-ink
+
+纯白背景上的黑色墨水，辅以稀疏的语义强调色
+
+## 背景
+
+- 颜色：纯白 (#FFFFFF)
+- 纹理：干净，无颗粒，无色调
+
+## 颜色
+
+| 角色 | 颜色 | Hex | 用途 |
+| ------ | ------- | ----- | ------- |
+| Background | 纯白 | #FFFFFF | Canvas |
+| Primary | 近黑 | #1A1A1A | 所有线条、文本、图形、箭头 |
+| Accent (风险/强调) | 珊瑚红 | #E8655A | 风险、问题、差距、关键强调 |
+| Accent (积极) | 柔和青色 | #5FA8A8 | 积极、解决方案、“后”状态 |
+| Accent (中性标签) | 灰淡紫 | #9B8AB5 | 中性标签、分类标签 |
+| Soft Fill | 淡灰 | #F0F0F0 | 柔和的区域背景（可选） |
+
+## 强调色
+
+所有结构元素（线条、文本、图形）均使用黑色墨水。强调色仅用于语义高亮：珊瑚红表示风险/差距/问题，柔和青色表示积极/解决方案/后状态，灰淡紫表示中性分类标签。彩色像素总数必须保持在画布的 10% 以下。淡灰色可用作柔和区域的背景，但绝不能占据主导地位。
+
+## 语义约束
+
+白色画布上的黑色墨水。强调色仅用于语义高亮——彩色像素总数不超过画布的 10%。不要在图像中将颜色名称、Hex 代码或角色标签渲染为可见文本。
+
+## 兼容于
+
+- `ink-notes`（主要、默认搭配）
+- `minimal`（严格的单色变体，去除该样式内置的强调色）
+- `sketch`（铅笔 + 墨水混合外观）
+
+## 不推荐与以下风格搭配
+
+- `sketch-notes` —— 其“禁止纯白背景”的规则相冲突
+- `warm`、`elegant`、`watercolor`、`fantasy-animation` —— 设计上本就偏重色彩，mono-ink 会剥夺它们的特性
+
+## 最适用于
+
+专业视觉笔记、Before/After 文章、技术宣言、框架类比、白板演示说明

package/extensions/skills/optional/creative/baoyu-article-illustrator/references/palettes/neon.md

@@ -0,0 +1,33 @@
+# neon
+
+深色背景上的鲜艳霓虹色彩
+
+## 背景
+
+- 颜色：深紫色 (#2D1B4E)
+- 纹理：细腻的网格图案或纯深色
+
+## 颜色
+
+| 角色 | 颜色 | Hex | 用途 |
+| ------ | ------- | ----- | ------- |
+| Background | 深紫色 | #2D1B4E | 主要背景 |
+| Alt Background | 深青色 | #0F4C5C | 替换区块 |
+| Primary | 亮粉色 | #FF1493 | 主强调色 |
+| Secondary | 电青色 | #00FFFF | 辅助元素 |
+| Tertiary | 霓虹黄 | #FFFF00 | 高亮 |
+| Accent 1 | 青柠色 | #32CD32 | 活力、成功 |
+| Accent 2 | 橙色 | #FF6B35 | 温暖 |
+| Text | 白色 | #FFFFFF | 文本元素 |
+
+## 强调色
+
+使用亮粉色 (#FF1493) 作为主要强调。高对比度的暗底霓虹色彩可创造直接的视觉冲击力。
+
+## 语义约束
+
+鲜艳的暗底霓虹调色板。高对比度，产生直接的视觉冲击力。请勿在图像中将颜色名称、Hex 代码或角色标签渲染为可见文本。
+
+## 最适用场景
+
+游戏、复古科技、80/90 年代怀旧内容、醒目的社论排版、潮流与流行文化

package/extensions/skills/optional/creative/baoyu-article-illustrator/references/palettes/warm.md

@@ -0,0 +1,32 @@
+# warm
+
+柔和蜜桃色上的温暖大地色调，不使用冷色调
+
+## Background
+
+- 颜色：柔和蜜桃色 (#FFECD2)
+- 纹理：温暖的纸张纹理
+
+## Colors
+
+| 角色 | 颜色 | Hex | 用途 |
+| ------ | ------- | ----- | ------- |
+| Background | Soft Peach | #FFECD2 | 主背景 |
+| Outlines | Deep Charcoal | #2D2D2D | 所有元素轮廓 |
+| Primary | Warm Orange | #ED8936 | 主要强调色 |
+| Secondary | Terracotta | #C05621 | 温暖的层次感 |
+| Tertiary | Golden Yellow | #F6AD55 | 高光，活力 |
+| Accent | Deep Brown | #744210 | 沉稳，锚定 |
+| Text | Warm Charcoal | #4A4A4A | 文本元素 |
+
+## Accent
+
+使用暖橙色 (#ED8936) 作为主要强调。纯暖色调色板——不使用冷色调（无绿色、蓝色、紫色）。兼具现代与复古感。
+
+## Semantic Constraint
+
+温暖的大地色调色板。纯暖色——不使用冷色调（无绿色、蓝色、紫色）。请勿在图像中将颜色名称、hex 代码或角色标签渲染为可见文本。
+
+## Best For
+
+产品展示、团队介绍、功能网格、品牌内容、个人成长、生活方式