image-poster

图像海报技能

除非用户要求提供多个变体，否则每轮只生成一张成品图像。图像生成需要紧凑、结构化的提示词——你的工作是根据用户的简报整理提示词，然后提交生成请求。

资源映射

image-poster/
├── SKILL.md         ← you're reading this
└── example.html     ← what the resulting card looks like in Examples

工作流

步骤 0 — 阅读项目元数据

当前项目包含 imageModel、imageAspect 和（可选的） imageStyle 说明。将它们用作上游模型、画布和风格的依据；只有在它们标记为 (unknown — ask) 时，才请用户补充。

步骤 1 — 编写提示词

调用任何工具前，严格按照以下顺序进行规划：

1. 主体 + 构图 — 画面中有什么、位于何处、占多大比例；视线位置和裁切方式。
2. 光线 + 氛围 — 自然光 / 影棚光 / 戏剧性光线；暖色 / 冷色；主光、轮廓光和补光；户外场景还要注明一天中的时间。
3. 调色板 + 纹理 — 用户提供了品牌调色板时，使用十六进制色值；否则用 3 个词标记氛围（例如“柔和赭黄 + 墨色”）。
4. 相机 / 镜头 — 仅在用户要求照片级写实效果（“85mm 人像镜头，浅景深”）或指定胶片类型时使用。
5. 避免事项 — 常见的 AI 滥用模式（“不要多余的手指、扭曲的文字或占位徽标”）。

步骤 2 — 通过媒体契约提交生成请求

使用统一调度器——不要手动调用上游提供商的 API。通过 shell 工具运行：

node "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface image \
  --model "<imageModel from metadata>" \
  --aspect "<imageAspect from metadata>" \
  --output "<short-descriptive-name>.png" \
  --prompt "<the full assembled prompt from Step 1>"

该命令会输出一行 JSON：{"file": {"name": "...", ...}}。 守护进程会将字节写入项目文件夹；FileViewer 会自动加载该文件。

步骤 3 — 交付

用一段话概述所用提示词，并提供调度器返回的文件名（例如 我使用 gpt-image-2 以 1:1 比例生成了 hero-poster.png。）。不要输出 <artifact> 标签。

硬性规则

• 除非用户要求提供多个变体，否则每轮只生成一张图像。
• 严格遵循 imageAspect——上游成本相同；匹配宽高比可避免重新渲染。
• 除非用户要求在画面中添加文字，否则不要在图像本身加入填充性文字。真实文案胜过占位文本。
• 保存每次渲染结果——绝不要只描述图像而不生成文件。用户希望能在文件查看器中打开文件。