SuperAPI AI 工具集

generate-characters

编程与开发

查看项目

更新于 10-15 17:17

技能介绍

用途:为视频项目生成一致的人物设计参考图,服务于分镜与视频生成。触发场景包括用户需要生成人物参考图、运行 /generate-characters 命令,或剧本中有人物缺少 character_sheet 路径。

主要能力与工作流程:先加载项目剧本(未指定项目名时询问用户),从 projects/{项目名}/scripts/ 读取剧本 JSON,列出没有 character_sheet 路径的人物;随后为每个人物构建详细 prompt,运行 .claude/skills/generate-characters/scripts/generate_character.py,将结果保存到 projects/{项目名}/characters/;接着展示每张生成图,询问用户批准或重新生成,允许调整描述,最后更新剧本 JSON 中的 character_sheet 路径。

Prompt 实践:使用 Gemini 3 Pro Image API。建议先阅读 docs/nano-banana.md 第 365 行起的 Prompting guide and strategies。核心原则是描述场景而非罗列关键词,用叙事性段落而不是零散词汇。人物描述应连贯描述外貌、服装与气质,包含年龄、体态、面部特征和服饰细节,可暗示气质或情绪。模板为专业人物设计三视图:三个等比例全身像水平排列于纯净浅灰背景,左侧正面、中间四分之三侧面、右侧纯侧面,柔和均匀摄影棚照明,无强烈阴影;画风由项目 style 字段决定,不使用固定漫画或动漫描述。

API 用法:使用 lib/gemini_client.py,调用 GeminiClient().generate_image,传入 prompt、aspect_ratio 如 9:16、output_path 如 projects/{项目名}/characters/{人物名}.png。

限制:资料未说明收费、价格、平台支持范围或具体效果保证;示例中的命令与路径需按实际项目结构使用。