用途：为视频项目中的线索（clues）生成设计图，确保重要道具与环境在多个场景中视觉一致。线索分道具类（信物、武器、信件、首饰等）与环境类（标志性建筑、特定树木、场所等）。
主要能力与流程：先加载 projects/{项目名}/project.json，列出 importance='major' 且没有 clue_sheet 的线索；按类型选用 prompt 模板，运行 .claude/skills/generate-clues/scripts/generate_clue.py 生成并保存到 projects/{项目名}/clues/；展示结果供用户批准或重新生成，支持调整描述；最后更新 project.json 中的 clue_sheet 路径并同步项目状态。
使用方式（命令保持原样）：
生成所有待处理的线索
python .claude/skills/generate-clues/scripts/generate_clue.py <项目名> --all
生成指定线索
python .claude/skills/generate-clues/scripts/generate_clue.py <项目名> --clue "玉佩"
列出待生成的线索
python .claude/skills/generate-clues/scripts/generate_clue.py <项目名> --list
调用 API 使用 lib/gemini_client.py 的 GeminiClient，通过 generate_image(prompt, aspect_ratio="16:9", output_path=...) 生成图像。编写描述遵循叙事式段落写法，描述形态、质感、材质、颜色、尺寸和可识别独特特征，避免堆砌关键词。道具模板输出多视角展示与细节特写，环境模板输出主画面加右下角细节图。生成分镜时，线索的 clue_sheet 会作为参考图传入 API。
适用场景：需要为分镜和视频生成提供一致的线索参考图，或在 project.json 中新增线索（含名称、类型、描述、重要程度、clue_sheet 字段）并在剧本场景里用 clues_in_scene 引用线索时。
限制：需先阅读 docs/nano-banana.md 相关 Prompting guide 章节；依赖 Gemini 图像生成 API 与本地项目数据结构；具体收费、价格、平台与效果资料暂未提供。