安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install muse-illustration
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 muse-illustration。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Muse Illustration 是一项 AI 代理技能，可将诗歌、引人入胜的图像或一句话创意等文学输入转化为一幅或多幅插画或海报。它会分析输入内容，识别视觉元素和情绪，然后将它们与选定的风格配方结合，以引导图像生成。
与仅保存成品图像的工作流不同，这项技能会维护可重复使用的风格配方，其中包括正向提示词、负向约束、参考图像和参数。不断扩充的素材库支持手动选择风格或自动推荐，同时让用户掌控选择，以及决定哪些成功结果可成为示例。它适用于能够读取开放 Agent Skill 格式的代理；图像生成需要兼容的文生图工具。

应用场景

将诗歌、歌词或文学段落转化为插画。
根据几个引人入胜的词语、视觉主题或一句灵感火花创作图像。
使用风格库中已有的风格制作海报或配套艺术作品。
比较同一概念的多种视觉变体，然后选出最喜欢的一种。
按指定格式制作艺术作品，例如竖版插画、社交媒体图像、方形图形、横向图像或带标题的海报。
根据用户认可的风格和采用的示例，建立可重复使用的风格库。

工作原理

分析输入： 判断输入是诗歌、意象还是简短创意，然后提取主体、场景、动作、色彩线索、情绪基调以及时间或背景。如果简短创意缺乏细节，可提供意象检查清单供用户确认，用户也可以跳过。
选择风格： 如果用户指定了库中的风格，就直接使用。否则，提供包括自动风格匹配以及 assets/styles/ 下所有风格的选项。自动匹配会根据意象和情绪推荐风格。
设置输出选项： 让用户选择 1、2 或 4 张图像，以及所需格式或宽高比。如果未指定，则使用所选风格的默认值。
组合提示词： 将风格的正向提示词应用于提取出的意象，并加入其负向约束。如果有可用的随附参考图像，则将其作为风格锚点，并明确说明只用于视觉风格，而非复制构图。
生成图像： 使用选定的尺寸和高质量设置调用已配置的文生图工具。生成前，告知用户文档中的预估费用约为每张图像 5–10 个积分。生成变体时，重复使用提示词或对措辞进行细微调整。
展示并归档： 使用代理的文件展示功能显示生成的图像，并询问用户是否想采用某个结果。只有在用户采用后，才按照日期和 slug 命名约定将图像复制到 assets/cases/images/，并使用提供的模板追加案例记录。

配置指南

获取 Muse Illustration 技能文件，并将技能目录放到代理使用的技能位置。具体位置和安装命令取决于宿主环境；该技能没有规定通用安装程序。
例如，如果技能目录在本地可用，可将其复制到宿主配置的技能目录中：

将此项设置为代理宿主配置的技能目录。

export AGENT_SKILLS_DIR="/path/to/agent/skills"
cp -R ./muse-illustration "$AGENT_SKILLS_DIR/muse-illustration"
确认已安装的目录包含 SKILL.md、references/ 和 assets/。将随附的风格参考文件和素材库文件与技能放在一起。
在代理宿主中配置或启用兼容的文生图工具。技能本身不提供图像生成功能，工具的设置方式取决于宿主环境。
使用能够读取开放 Agent Skill 格式的代理，例如 Claude Code、Codex、Cursor、Gemini CLI、Copilot 或 WorkBuddy。该技能采用 MIT 许可证，也可用于兼容 Openclaw Skills 的工作流。

数据架构

该技能存储可重复使用的配方和精选示例，而不是将生成的图像视为主要的可重复使用资产。
路径 内容和用途
assets/styles//meta.yaml 风格元数据，包括风格的 name 和用于风格列表及推荐的情绪信息。
assets/styles//prompt.positive.txt 描述预期视觉处理方式的正向提示词配方。
assets/styles//prompt.negative.txt 有助于避免不想要结果的明确排除项和约束。
assets/styles//ref.jpg 随附的视觉参考，用于锚定风格和笔触，而非复制构图。
assets/lexicon/imagery.yaml 将意象映射到视觉元素的词汇表。
assets/cases/ 用户采用的示例和积累的经验；案例条目遵循 references/style-spec-template.md。
assets/cases/images/YYYY-MM-DD-.jpg 与案例记录关联的已采用图像的独立副本。
/generated-images 生成输出文件的默认目标位置。
使用风格规范模板在 assets/styles/ 下添加风格。只有在用户确认后，新风格才会加入素材库；风格选择选项会从素材库中发现，而不是硬编码。生成的图像不会自动升级为示例；是否采用由用户决定。

高级特性

不断扩充的风格库：
每种风格都是易于维护的配方，结合正向提示词、负向约束、参考图像和参数。
自动风格匹配：
根据提取的意象，尤其是情绪和场景，推荐风格，同时提供素材库中的全部风格供用户直接选择。
组件级提示词指导：
优先使用如何描绘屋顶、墙壁或水面等具体视觉指令，而不是含糊的形容词，以获得更可复现的结果。
负向约束：
将排除项视为提示词配方的重要组成部分，与正向指引并列。
参考图像锚定：
使用随附参考图像引导风格和笔触，同时明确避免复制其构图。
批量变体和格式选择：
生成 1、2 或 4 张图像，并支持竖版 2:3、小红书 3:4、方形 1:1、横向 3:2 或带标题的海报格式。
海报文字单独排版：
由于图像模型可能无法可靠呈现中文文字，海报标题文字通过本地排版处理，而不依赖图像生成。
用户认可的学习循环：
仅归档用户采用的结果；将新风格加入素材库前必须获得确认。

name: muse-illustration description: Turn poems, imagery, or a one-line spark of inspiration into illustrations or posters, using a growing built-in style library. 把诗词、词句、意象或一句话灵感，转化为插画或海报。当用户提供一首诗词 / 词句 / 意象词 / 一句灵感，并要求画成画、出图、生成插画、做海报、配图，或要求用某个已收录风格出图时使用。内置可成长的风格库（风格配方 = 正向提示词 + 负向约束 + 参考图 + 参数），并支持选择风格（选择框内含「自动匹配风格」一项，可按意象与情绪推荐）、出图张数与成品形态。 license: MIT
compatibility: Works with any agent that reads the open Agent Skill format (SKILL.md) — Claude Code, Codex, Cursor, Gemini CLI, Copilot, WorkBuddy and more. Image generation requires a text-to-image tool; style reference images are bundled.