海报设计生成助手

技能文档

---
name: poster-generate
title: 海报设计生成助手
description: 专业海报与视觉设计生成器：文生图与图生图生成海报、封面、书籍封面等视觉设计稿，支持 2k/4k 分辨率与多种宽高比，最多 3 张参考图。当用户需要「做一张海报」「生成封面」「设计书籍封面」或提出其他视觉设计请求时触发，也可配合提示词优化建议使用。
category: 内容创作
---

## 运行前环境检查（每次执行前必做）

在开始写作流程前，**直接询问用户**是否已配置好以下环境：
1. **已安装Python**
2. **已配置 ARK_API_KEY 环境变量（图像生成服务的 API Key）**
如全部配置好，回复"已配置好"直接开始。
如有未配置的，告诉我哪一项，我会指导你如何获取。

**用户回复后的处理：**
\- **「已配置好」或类似确认** → 直接进入完整工作流程
- **有缺失项** → 针对性指导配置：
  - Python 安装：引导至 Python 官方网站下载安装 Python
  - ARK_API_KEY：引导用户到图像生成服务控制台获取 API Key，询问用户电脑系统是 Windows 还是 Mac，并提示不同系统下配置环境变量的方法。



## 技能工作流

### 步骤1：确认是否需要优化提示词
用户输入初始提示词后，先明确询问用户：**“是否需要我先优化提示词？”**

- **用户选择“需要优化”** → 根据 `references/prompt-guide.md` 优化提示词，展示优化结果并询问是否继续调整；确认后进入第二步
- **用户选择“不优化”** → 使用用户原始提示词，直接进入第二步调用脚本生成

### 步骤2： 生成海报
1. 告诉用户生成海报的可选分辨率：2k, 4k
2. 告诉用户生成海报的可选比例：1:1, 3:4, 4:3, 9:16, 16:9, 21:9, 2:3, 3:2
3. 可选图生图，支持最多上传3张图片
- 脚本将本地文件编码后填入 API 的 `image` 数组。
- 如果用户需要对之前生成的图片进行调整，请把之前的图片填入API，并且不要对用户的修改需求（如"调整物体的颜色”、“调整物体的位置”）做任何改动。
4. 调用 `seedream.py` 脚本生成海报（在 `skills/poster-generate` 目录下执行时，路径见下方命令行说明）。

---

## 命令行使用

### 基本语法

```bash
python3 scripts/seedream.py --prompt "图片描述" --resolution 2k --ratio 3:4
```

图生图（1～3 张本地参考图，可重复 `--image`）：

```bash
python3 scripts/seedream.py --prompt "将图1的主色换为图2的配色" --resolution 2k --ratio 3:4 --image ./a.png --image ./b.png
```

文生图

```bash
python3 scripts/seedream.py --prompt "一个穿着华丽服装的女孩，撑着遮阳伞走在林荫道上" --resolution 2k --ratio 3:4
```

### 参数说明

| 参数 | 说明 | 默认值 | 可选值 |
|------|------|--------|--------|
| `--prompt` | 图片描述提示词（必需） | - | 任意文本 |
| `--resolution` | 分辨率 | 2k | 2k, 4k |
| `--ratio` | 宽高比 | 3:4 | 1:1, 3:4, 4:3, 9:16, 16:9, 21:9, 2:3, 3:2 |
| `--image` | 参考图，**仅本地文件路径**；`--image` 可写多次，**最多 3 次** | - | `.png` / `.jpg` / `.jpeg` / `.webp` / `.gif` |
| `--output` | 自定义输出路径 (必填) | - |任意路径|

---

使用说明

# 海报设计生成助手

专业海报与视觉设计生成器，支持文生图与图生图，输出 2k/4k 海报设计稿。

## 适用场景

- 海报、封面、书籍封面等视觉设计
- 基于参考图改色、调整构图的图生图

## 最简用法

```bash
python3 scripts/seedream.py --prompt "一个穿华丽服装的女孩，撑着遮阳伞走在林荫道上" --resolution 2k --ratio 3:4 --output ./poster.png
```

## 说明

- 需配置 `ARK_API_KEY` 环境变量（图像生成服务 API Key）
- 可选比例：1:1、3:4、4:3、9:16、16:9、21:9、2:3、3:2
- 提示词写法建议见 references/prompt-guide.md

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。