creatok-generate-image

generate-image

约束

• 面向用户的最终回复应与用户输入的语言一致，默认使用英语。
• 触发任何付费或高成本的图像生成调用前，必须先征得用户确认。
• 用户确认后，必须调用 CreatOK Open Skills 代理并等待任务完成。
• 除非用户明确需要调试详情，否则面向用户的回复应避免使用技术术语。

模型选择规则

运行时必须从 CreatOK capabilities 端点读取模型列表、默认值和硬性限制，不得在本地硬编码。

保持本地客户端精简：

• 除非用户明确选择其他受支持的模型，否则使用返回的默认模型
• 仅验证分辨率、宽高比、数量和参考图上限等硬性执行约束
• 面向用户的模型说明应尽量简短，避免依赖提供商、系列或提示风格等元数据

需要澄清的输入（缺失时询问）

• 只询问生成优质图像所必需的信息
• 如果未指定分辨率或宽高比，使用 capabilities 端点返回的模型默认值
• 如果提示词过于模糊，在确认生成前主动提出帮助用户完善提示词
• 参考图为可选项——仅当用户暗示要进行风格迁移或参考主体时才询问
• 使用参考图时，先上传本地图片文件，再将返回的已上传参考图提交给生成任务

工作流

1. 确认关卡（必需）

• 总结：
  • 模型
  • 分辨率
  • 图像数量（n）
  • 如有指定，则说明宽高比
  • 如有估算费用/点数，则一并说明
• 提交前，请用户简单确认。
• 用户明确表示同意前，不得提交生成任务。

2. 提交图像生成任务

• 调用 CreatOK：POST /api/open/skills/image-generation

3. 轮询状态，直到任务完成

• 调用 CreatOK：GET /api/open/skills/tasks/status?task_id=...&task_type=image_generation

4. 保存产物并回复

• 写入：
  • outputs/result.json，包含 task_id/status/images/raw
  • outputs/result.md
• 提交后立即保存 task_id，以便用户之后恢复任务。
• 按原样返回最终图像 URL。

恢复已有任务

• 如果用户已有 task_id，请继续该任务，而不是启动新任务。
• 恢复模式下，如果已有任务 ID，不要要求用户重新描述提示词。
• 模型可以只检查一次状态，也可以在用户希望等待时持续轮询。
• 如果任务成功，按原样返回最终图像 URL。
• 如果任务仍在排队或运行，清楚说明状态，并询问是否继续检查。
• 如果任务失败，说明失败原因并建议后续步骤。

产物

所有产物均保存在 generate-image/.artifacts/<run_id>/... 下。

精简客户端边界

• 此技能负责提交生成任务、轮询状态并保存固定格式的输出。
• 如果对话中已明确用户的想法，模型不应要求用户重新描述。