ahang1598 创客贴 AI 创作 Skill
创客贴 Agent 面向 AI 图片、设计和视频创作。用户的所有生成、编辑、续作、复刻和复杂创作需求都通过自然语言消息发送给 Agent，由后端自主编排模型、工具和工作流。复杂任务可能耗时较长，例如短剧、MV、视频复刻、产品广告片、分镜/故事板和多轮设计修改，需要耐心轮询。
适用场景
只要用户请求涉及 AI 图片、设计或视频的创作、生成、编辑、修改、续作、下载、查看进度，就使用这个 skill。典型说法包括：
- 生成类：
画只猫、做个海报、生成一张电商主图、文生图、文生视频、图生视频、做个动画、来段宣传片。 - 编辑类：
把纸船换成爱心、去掉背景里的人、加上品牌 logo、改成国潮风、调整镜头、局部修改、这个视频帮我改一下。 - 风格类：
转绘、换风格、风格迁移、做成动漫风、复刻这段视频的质感。 - 视频类：
视频续写、延长这个片段、复刻 TVC、做产品展示片、用这首歌做 MV、一句话生成短剧、做短漫剧。 - 工作流类：
上传参考图、上传参考视频、查一下进度、下载生成结果、继续刚才的设计、在上一版基础上改。
标准流程
- 有本地素材时，先上传素材。
- 需要新建或切换画布时，执行
design switch。 - 使用
message send发起创作请求。 - 保存返回的
request_id、session_id、design_id和design_url。 - 使用
request status轮询任务。 - 任务完成后执行
result download。 - 返回画布链接design_url、下载文件路径和后续续作所需的
session_id。
能力范围
- 切换设计：切到已有
design_id，或创建一个全新设计作为当前默认设计。 - 发送消息：向会话发送自然语言创作/编辑请求，并返回
request_id。不传session_id时，创客贴Agent会自动创建新会话并返回。 - 查询进展：按
request_id查询单次请求状态和增量消息。 - 上传文件：上传图片或视频参考素材，返回后续消息可引用的
file_key。 - 下载结果：从会话消息或请求结果中提取生成图片链接并下载到本地。
- 打开画布：通过
design_url让用户进入创客贴画布继续编辑。
用户意图处理
- 不补充用户没要求的品牌、风格、尺寸或文案。
- 用户有明确约束时必须保留，例如平台、比例、颜色、文案、禁止项。
- 用户要求优化表达时，可以轻微整理，但不要改变创意目标。
- 用户只给素材没给明确需求时，先用简短问题确认要生成什么，不要直接发空泛任务。
- 保留用户原始意图。把用户需求原样或近似原样传给创客贴 Agent，不要擅自改成另一种创意方向。
可用命令
上传参考素材
ckt-agent asset upload --file /path/to/reference.png
参数：
--file：必填，本地图片或视频文件路径。--biz-type：可选，默认agent_skill。
返回 file_key，后续通过 --image-file-key 引用。
切换或新建设计
ckt-agent design switch
ckt-agent design switch --design-id "<design_id>"
不传 --design-id 时创建并切换到新设计。
发起创作请求
ckt-agent message send \
--message "根据参考图生成一张夏日饮品海报" \
--image-file-key "<file_key>"
续作已有会话：
ckt-agent message send \
--session-id "<session_id>" \
--message "保留主体，把背景改成蓝绿色渐变"
参数：
--message：必填，创作或编辑需求。--session-id：可选，继续已有会话。--image-file-key：可选，可重复，用已上传素材的file_key。--image-url：可选，可重复，公开参考图 URL。
查询任务状态
ckt-agent request status --request-id "<request_id>"
增量查询：
ckt-agent request status \
--request-id "<request_id>" \
--last-message-id "<next_last_message_id>"
任务未完成时，按 3 至 5 秒间隔继续查询；视频或复杂任务可适当延长间隔。
下载结果
ckt-agent result download --request-id "<request_id>"
用户指定目录时：
ckt-agent result download \
--request-id "<request_id>" \
--output-dir "/path/to/output"
也可以从已有状态 JSON 下载：
ckt-agent result download --poll-file "/path/to/status.json"
使用约束
- 本地素材必须先上传，不能直接把本地路径写入创作消息。
- 用户要求继续上一版时复用
session_id。 - 用户要求新方向时切换
design_id。 - 轮询时保存并复用
next_last_message_id。 - 不要把私有
file_key当作公开链接返回。 - 失败时返回错误信息和相关 ID，不得伪造完成结果。
- 任务完成后优先返回
design_url、本地下载文件路径和session_id。
结果交付
正常完成时，回复内容应包含：
- 设计画布链接：
design_url,如果参数没有返回，则按照规则拼接返回，设计画布地址点我查看画布 - 本地下载文件：
download_results.py返回的文件路径 - 后续续作所需信息：
session_id
如果没有下载到图片，但任务已完成：
- 返回
design_url - 简要说明轮询结果中没有可下载图片
- 保留
request_id供后续排查
失败处理
- 上传失败：说明哪个文件失败，不继续提交依赖该素材的任务。
- 发起任务失败：返回接口错误信息，保留用户原始需求。
- 轮询失败：返回
request_id和错误信息，方便继续排查。 - 下载失败：不要宣称文件已下载；返回
design_url和失败原因。 - 任何失败都提示用户可以访问创客贴官网联系客服处理，提供对应的request_id，session_id，design_id任意都可以，官网地址创客贴官网