name: pw-cover-image
description: |
为文章内容生成精美封面图的专用工具。

核心功能:
- 分析文章内容并自动选择最适合的视觉风格
- 生成手绘风格的高质量封面图片
- 支持 19 种预设风格 (elegant, blueprint, bold-editorial 等)
- 支持多种宽高比 (2.35:1 电影感, 16:9 宽屏, 1:1 方形)
- 自动提取核心主题并生成标题文字

使用时机:
- 用户明确要求 "生成封面图"、"创建文章封面"、"制作封面"
- 用户提供文章内容并需要配图
- 用户需要为博客、公众号、社交媒体制作封面

不适用场景:
- 用户只是询问如何制作封面 (提供建议即可)
- 用户需要编辑现有图片 (使用图片编辑工具)
- 用户需要生成非封面类型的图片 (使用通用图片生成工具)

封面图生成器

为文章生成手绘风格封面图, 支持多种风格选项。

快速开始

最简单的用法:

/pw-cover-image path/to/article.md

系统会自动分析内容、选择风格、生成封面。

常用场景:

# 技术文章
/pw-cover-image article.md --style blueprint

# 社交媒体方形封面
/pw-cover-image article.md --aspect 1:1

# 纯视觉背景 (无标题)
/pw-cover-image article.md --no-title

# 视频封面
/pw-cover-image article.md --aspect 16:9 --style bold-editorial

文档导航:
- 参数说明 → 了解所有可用参数
- 风格画廊 → 查看 19 种预设风格
- 常见问题与错误处理 → 解决使用问题
- 使用建议与最佳实践 → 提高封面质量
- 工作流程 → 了解内部处理步骤

使用方法

# 从 markdown 文件生成 (根据内容自动选择风格)
/pw-cover-image path/to/article.md

# 指定风格
/pw-cover-image path/to/article.md --style blueprint
/pw-cover-image path/to/article.md --style warm
/pw-cover-image path/to/article.md --style dark-atmospheric

# 不包含标题文字
/pw-cover-image path/to/article.md --no-title

# 组合选项
/pw-cover-image path/to/article.md --style minimal --no-title

# 从直接输入的文本生成
/pw-cover-image
[粘贴内容或描述主题]

# 直接输入并指定风格
/pw-cover-image --style playful
[粘贴内容]

参数说明

--style

指定封面的视觉风格。

参数类型: 字符串 (可选)

可选值: 见下方 "风格画廊" 章节的 19 种预设风格

默认行为: 如果不指定, 系统会根据文章内容自动选择最合适的风格

使用示例:

/pw-cover-image article.md --style blueprint  # 技术文档使用蓝图风格
/pw-cover-image article.md --style warm      # 个人故事使用温暖风格

最佳实践:
- 技术类文章推荐: blueprint, intuition-machine, editorial-infographic
- 产品类文章推荐: bold-editorial, notion, minimal
- 故事类文章推荐: warm, watercolor, fantasy-animation
- 不确定时留空, 让系统自动选择

--aspect

指定封面图片的宽高比。

参数类型: 字符串 (可选)

可选值:
- 2.35:1 - 电影感超宽屏 (默认), 适合博客头图、横幅
- 16:9 - 标准宽屏, 适合视频封面、演示文稿
- 1:1 - 方形, 适合社交媒体 (微信、微博、Instagram)

默认值: 2.35:1

使用示例:

/pw-cover-image article.md --aspect 16:9  # 视频封面
/pw-cover-image article.md --aspect 1:1   # 社交媒体

最佳实践:
- 博客文章: 使用 2.35:1 获得更强视觉冲击力
- 视频内容: 使用 16:9 匹配视频平台
- 社交分享: 使用 1:1 确保在各平台显示完整

--lang

指定封面标题文字的语言。

参数类型: 语言代码 (可选)

可选值: en (英文), zh (中文), ja (日文) 等标准语言代码

默认行为:
- 如果文章语言与对话语言一致, 自动使用该语言
- 如果不一致, 会在生成前询问用户选择

使用示例:

/pw-cover-image article.md --lang en  # 强制使用英文标题
/pw-cover-image article.md --lang zh  # 强制使用中文标题

最佳实践:
- 目标读者是中文用户: 使用 zh
- 国际化内容: 使用 en
- 通常不需要手动指定, 系统会智能判断

--no-title

生成不含标题文字的纯视觉封面。

参数类型: 布尔标志 (可选)

默认行为: 包含标题文字

使用场景:
- 需要后期添加自定义文字
- 纯视觉背景图
- 需要在不同场合使用不同标题

使用示例:

/pw-cover-image article.md --no-title
/pw-cover-image article.md --style minimal --no-title

注意事项:
- 使用此选项后, 封面将只包含视觉元素和装饰
- 适合需要灵活性的场景

风格画廊

详细风格定义: references/styles/<style>.md

自动风格选择

当未指定 --style 时, 系统会分析内容选择最佳风格:

文件管理

输出目录

每个会话创建一个以内容主题命名的独立目录:

cover-image/{topic-slug}/
├── source-{slug}.{ext}    # 源文件 (文本、图片等)
├── prompts/
│   └── cover.md
└── cover.png

主题命名规则:
1. 从内容中提取主题 (2-4 个词, kebab-case)
2. 示例: "AI 的未来" → ai-future

冲突解决

如果 cover-image/{topic-slug}/ 已存在:
- 追加时间戳: {topic-slug}-YYYYMMDD-HHMMSS
- 示例: ai-future 已存在 → ai-future-20260118-143052

源文件

使用 source-{slug}.{ext} 命名复制所有源文件:
- source-article.md (主要文本内容)
- source-logo.png (对话中的图片)

支持多个源文件: 文本、图片、对话中的文件。

工作流程

流程概览:
1. 分析内容 → 提取主题、语气、关键词
2. 确定选项 → 自动选择或使用指定的风格、宽高比
3. 确认选项 → 一次性确认所有参数 (风格、宽高比、语言)
4. 生成概念 → 创建标题和视觉元素
5. 创建提示词 → 保存到 prompts/cover.md
6. 生成图片 → 调用图片生成服务
7. 输出摘要 → 显示结果和文件位置

用户交互点:
- 仅在步骤 3 需要用户确认 (一次性确认所有选项)
- 如果有多个图片生成服务, 在步骤 6 询问选择

步骤 1: 分析内容

1. 保存源内容 (如果还不是文件):
2. 如果用户提供文件路径: 直接使用

3. 如果用户粘贴内容: 保存到目标目录的 source.md

4. 提取关键信息:

5. 主题: 文章讲什么?
6. 核心信息: 关键要点是什么?
7. 语气: 严肃、有趣、鼓舞人心、教育性?

8. 关键词: 识别风格信号词

9. 语言检测:

10. 检测内容的源语言
11. 检测对话上下文的用户语言
12. 注意源语言 ≠ 用户语言 (将在步骤 3 询问)

步骤 2: 确定选项

1. 风格选择:
2. 如果指定了 --style, 使用该风格
3. 否则, 扫描内容的风格信号并自动选择 3 个候选

4. 如果没有明确信号, 默认使用 elegant

5. 宽高比:

6. 如果指定了 --aspect, 使用该比例
7. 否则, 准备选项: 2.35:1 (电影感), 16:9 (宽屏), 1:1 (社交媒体)

步骤 3: 确认选项

目的: 让用户在生成前一次性确认所有选项。

重要: 使用 AskUserQuestion 在单个确认步骤中呈现所有选项。不要用多个单独的确认打断工作流程。

确定要询问的问题:

呈现选项 (使用 AskUserQuestion 包含所有适用问题):

问题 1 (风格) - 总是:
- 风格 A (推荐): [风格名称] - [简要说明]
- 风格 B: [风格名称] - [简要说明]
- 风格 C: [风格名称] - [简要说明]
- 自定义: 提供自定义风格参考

问题 2 (宽高比) - 总是:
- 2.35:1 电影感 (推荐) - 超宽、戏剧性
- 16:9 宽屏 - 标准视频/演示
- 1:1 方形 - 社交媒体优化

问题 3 (语言) - 仅当源语言 ≠ 用户语言:
- [源语言] (匹配内容)
- [用户语言] (你的偏好)

语言处理:
- 如果源语言 = 用户语言: 只需告知用户 (例如 "标题将使用中文")
- 如果不同: 询问标题文字使用哪种语言

步骤 4: 生成封面概念

根据选定的风格创建封面图概念:

标题 (如果包含, 最多 8 个字符):
- 将核心信息提炼为有力的标题
- 使用钩子: 数字、问题、对比、痛点
- 如果使用 --no-title 标志则跳过

视觉元素:
- 符合风格的图像和图标
- 1-2 个代表主题的象征性元素
- 符合风格的隐喻或类比

步骤 5: 创建提示词文件

使用确认的选项将提示词保存到 prompts/cover.md。

所有提示词都使用用户确认的语言偏好编写。

提示词格式:

封面主题: [2-3 个词的主题]
风格: [选定的风格名称]
宽高比: [确认的宽高比]

[如果包含标题:]
标题文字: [8 个字符或更少, 使用确认的语言]
副标题: [可选, 使用确认的语言]

视觉构图:
- 主视觉: [匹配风格的描述]
- 布局: [基于标题包含和宽高比的定位]
- 装饰元素: [符合风格的元素]

配色方案:
- 主色: [风格主色]
- 背景: [风格背景色]
- 点缀: [风格点缀色]

风格注释: [要强调的特定风格特征]

[如果无标题:]
注意: 无标题文字, 仅纯视觉插图。

步骤 6: 生成图片

图片生成技能选择:
1. 检查可用的图片生成技能
2. 如果有多个技能可用, 询问用户选择

生成:
使用提示词文件、输出路径和确认的宽高比调用选定的图片生成技能。

步骤 7: 输出摘要

封面图已生成!

主题: [主题]
风格: [风格名称]
宽高比: [宽高比]
标题: [封面标题] (或 "无标题 - 仅视觉")
语言: [确认的语言]
位置: [输出路径]

预览图片以验证是否符合你的期望。

注意事项

• 封面应在小预览尺寸下立即可理解
• 标题 (如果包含) 必须可读且有冲击力
• 视觉隐喻比字面表现效果更好
• 在整个封面中保持风格一致性
• 图片生成通常需要 10-30 秒
• 标题文字使用用户确认的语言偏好
• 宽高比: 2.35:1 用于电影感/戏剧性, 16:9 用于宽屏, 1:1 用于社交媒体

常见问题与错误处理

文件路径问题

问题: 找不到指定的文章文件

原因: 文件路径不正确或文件不存在

解决方案:
- 确保使用绝对路径或相对于当前工作目录的正确路径
- 检查文件扩展名是否正确 (.md, .txt 等)
- 使用 ls 命令验证文件是否存在

示例:

# 错误
/pw-cover-image article.md  # 如果不在文件所在目录

# 正确
/pw-cover-image /path/to/article.md
/pw-cover-image ./docs/article.md

内容分析失败

问题: 无法从文章中提取有效主题

原因: 文章内容过短、格式不规范或语言不支持

解决方案:
- 确保文章至少包含 100 字以上的有效内容
- 检查文章是否包含标题、段落等基本结构
- 对于非标准格式, 可以手动指定风格参数

最佳实践:
- 提供完整的文章内容, 而非片段
- 包含标题和主要段落
- 避免纯代码或纯数据内容

风格选择不理想

问题: 自动选择的风格不符合预期

原因: 文章内容特征不明显或包含多种主题

解决方案:
- 使用 --style 参数手动指定风格
- 参考 "自动风格选择" 表格了解匹配规则
- 尝试不同风格并比较效果

示例:

# 如果自动选择不理想, 手动指定
/pw-cover-image article.md --style blueprint

图片生成超时

问题: 图片生成时间过长或失败

原因: 网络问题、图片生成服务繁忙或提示词过于复杂

解决方案:
- 等待 30-60 秒后重试
- 检查网络连接
- 简化内容或使用更简单的风格 (如 minimal)
- 使用 --no-title 减少生成复杂度

标题文字显示问题

问题: 标题文字过长或显示不完整

原因: 自动提取的标题超过 8 个字符限制

解决方案:
- 系统会自动精简标题到 8 个字符以内
- 如果仍不满意, 使用 --no-title 后期手动添加
- 在文章开头明确核心主题, 帮助系统提取更好的标题

语言识别错误

问题: 标题语言与预期不符

原因: 文章包含多种语言或语言检测不准确

解决方案:
- 使用 --lang 参数明确指定语言
- 在确认步骤中选择正确的语言选项

示例:

/pw-cover-image article.md --lang zh  # 强制中文标题

目录冲突

问题: 输出目录已存在, 担心覆盖之前的文件

原因: 相同主题的封面已生成过

解决方案:
- 系统会自动添加时间戳避免冲突
- 格式: {topic-slug}-YYYYMMDD-HHMMSS
- 不会覆盖现有文件, 可以安全重新生成

示例:

cover-image/ai-future/           # 第一次生成
cover-image/ai-future-20260123-143052/  # 第二次生成

使用建议与最佳实践

内容准备

提供完整文章:
- 包含标题、引言、主体段落
- 至少 200-500 字的有效内容
- 清晰的主题和核心观点

优化文章结构:
- 在开头明确核心主题
- 使用清晰的段落划分
- 包含关键词和主题词

风格选择策略

让系统自动选择 (推荐):
- 适用于大多数场景
- 系统会分析内容特征并推荐 3 个候选风格
- 在确认步骤中可以调整

手动指定风格:
- 品牌一致性要求高的场景
- 已知目标风格的情况
- 需要批量生成统一风格的封面

风格测试:
- 不确定时可以生成多个版本对比
- 使用 --no-title 生成纯视觉版本便于复用

宽高比选择

根据发布平台选择:
- 博客/网站头图: 2.35:1 (默认)
- 视频平台 (YouTube, B站): 16:9
- 社交媒体 (微信, 微博, Instagram): 1:1

多平台发布:
- 生成多个宽高比版本
- 使用相同风格保持一致性

示例工作流:

# 为同一文章生成多个版本
/pw-cover-image article.md --aspect 2.35:1  # 博客版
/pw-cover-image article.md --aspect 16:9    # 视频版
/pw-cover-image article.md --aspect 1:1     # 社交版

批量生成

系列文章:
- 使用相同的 --style 保持视觉一致性
- 让标题自动生成以体现差异
- 建立品牌识别度

示例:

/pw-cover-image article-1.md --style blueprint
/pw-cover-image article-2.md --style blueprint
/pw-cover-image article-3.md --style blueprint

质量优化

提高封面质量:
- 提供高质量的文章内容
- 明确核心主题和关键信息
- 选择与内容匹配的风格

标题优化:
- 在文章开头使用有力的标题
- 包含数字、问题或对比
- 避免过长或过于抽象的标题

视觉效果:
- 预览生成的封面
- 在目标尺寸下检查可读性
- 必要时重新生成或调整参数

工作流集成

与其他工具配合:
- 先完成文章写作
- 使用本工具生成封面
- 使用图片编辑工具进行微调 (如需要)

文件管理:
- 输出目录自动按主题组织
- 保留源文件和提示词便于追溯
- 定期清理不需要的版本

性能优化

减少生成时间:
- 使用简单风格 (minimal, elegant)
- 使用 --no-title 减少复杂度
- 避免在网络繁忙时段生成

提高成功率:
- 确保网络连接稳定
- 提供清晰的文章内容
- 使用推荐的参数组合

高级用法

自定义风格

通过 EXTEND.md 文件添加自定义风格配置。

配置路径 (优先级顺序):
1. .pw-skills/pw-cover-image/EXTEND.md (项目级)
2. ~/.pw-skills/pw-cover-image/EXTEND.md (用户级)

使用场景:
- 企业品牌风格
- 特定主题的定制风格
- 覆盖默认风格定义

提示词调试

查看生成的提示词文件了解系统如何理解内容。

位置: cover-image/{topic-slug}/prompts/cover.md

用途:
- 理解风格选择逻辑
- 调试生成问题
- 学习提示词编写

多图片生成服务

如果配置了多个图片生成服务, 系统会询问选择。

选择建议:
- 根据服务质量和速度选择
- 不同服务可能产生不同风格
- 可以尝试多个服务对比效果