원클릭으로 Manus에서 모든 스킬 실행

$pwd:

generate-clues

Name: Generate Clues
Author: ArcReel

// 使用 Gemini 图像生成 API 为视频生成线索设计图。使用场景：(1) 用户需要为项目生成线索参考图，(2) 用户运行 /generate-clues 命令，(3) project.json 中有 importance='major' 的线索没有 clue_sheet 路径。生成一致的线索设计用于分镜和视频生成。

Manus에서 실행

$ git log --oneline --stat

stars:10

forks:3

updated:2026년 2월 6일 07:24

파일 탐색기

2 개 파일

SKILL.md

readonly

name	generate-clues
description	使用 Gemini 图像生成 API 为视频生成线索设计图。使用场景：(1) 用户需要为项目生成线索参考图，(2) 用户运行 /generate-clues 命令，(3) project.json 中有 importance='major' 的线索没有 clue_sheet 路径。生成一致的线索设计用于分镜和视频生成。

生成线索设计图

使用 Gemini 3 Pro Image API 创建线索设计图，确保整个视频中重要物品和环境的视觉一致性。

Prompt 最佳实践

在编写线索描述和生成 Prompt 前，请先阅读 docs/nano-banana.md 第 365 行起的 Prompting guide and strategies 章节，了解 Gemini 图像生成的最佳实践。

核心原则：

"Describe the scene, don't just list keywords. A narrative, descriptive paragraph will almost always produce a better, more coherent image than a list of disconnected words."

线索描述编写指南

道具类（prop）

编写道具 description 时，请遵循叙事式写法：

✅ 推荐:

"一块翠绿色的祖传玉佩，约拇指大小，玉质温润透亮。表面雕刻着精致的莲花纹样，花瓣层层舒展，中心有一枚小小的莲蓬。玉佩上系着一根红色丝绳，打着传统的中国结。"

❌ 避免:

"玉佩，绿色，莲花纹，红绳"

环境类（location）

编写环境 description 时，同样使用叙事式：

✅ 推荐:

"村口的百年老槐树，树干粗壮需三人合抱，树皮龟裂沧桑。主干上有一道明显的雷击焦痕，从顶部蜿蜒而下。树冠茂密，夏日里洒下斑驳的树影。"

❌ 避免:

"老槐树，大，有雷击痕"

要点:

用连贯段落描述形态、质感、细节
包含材质、颜色、尺寸、特征
突出能在不同场景中识别的独特特征

概述

线索（clues）是需要在多个场景中保持一致的重要元素，包括：

道具类（prop）：信物、武器、信件、首饰等关键物品
环境类（location）：标志性建筑、特定树木、重要场所等

工作流程

加载项目元数据
- 如未指定项目名称，询问用户
- 从 projects/{项目名}/project.json 加载项目数据
- 列出 importance='major' 且没有 clue_sheet 的线索
生成线索设计
- 对于每个待生成的线索：
  - 根据类型（prop/location）选择对应的 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

Prompt 模板

道具类（prop）

一张专业的道具设计参考图，{项目 style}。

道具「[名称]」的多视角展示。[详细描述 - 叙事式段落]

三个视图水平排列在纯净浅灰背景上：左侧正面全视图、中间45度侧视图展示立体感、右侧关键细节特写。柔和均匀的摄影棚照明，高清质感，色彩准确。

环境类（location）

一张专业的场景设计参考图，{项目 style}。

标志性场景「[名称]」的视觉参考。[详细描述 - 叙事式段落]

主画面占据四分之三区域展示环境整体外观与氛围，右下角小图为细节特写。柔和自然光线。

API 使用

使用 lib/gemini_client.py：

from lib.gemini_client import GeminiClient

client = GeminiClient()
image = client.generate_image(
    prompt=clue_prompt,
    aspect_ratio="16:9",
    output_path=f"projects/{项目名}/clues/{线索名}.png"
)

质量检查清单

道具类

批准道具设计前检查：

三个视角清晰一致
细节符合描述（颜色、材质、尺寸）
特殊标记或纹理清晰可见
整体风格与项目一致

环境类

批准环境设计前检查：

整体构图符合描述
标志性特征突出
光线和氛围合适
细节图清晰可辨

线索管理

添加新线索

在 Claude 对话中添加线索：

请为项目添加一个新线索：
- 名称：玉佩
- 类型：prop
- 描述：一块翠绿色的祖传玉佩，约拇指大小，雕刻着莲花纹样，系着红色丝绳
- 重要程度：major

或直接编辑 project.json：

{
  "clues": {
    "玉佩": {
      "type": "prop",
      "description": "一块翠绿色的祖传玉佩，约拇指大小，雕刻着莲花纹样，系着红色丝绳",
      "importance": "major",
      "clue_sheet": ""
    }
  }
}

在场景中使用线索

在剧本的场景中添加 clues_in_scene 字段：

{
  "scene_id": "E1S3",
  "characters_in_scene": ["姜月茴"],
  "clues_in_scene": ["玉佩", "老槐树"],
  "visual": {
    "description": "姜月茴站在老槐树下，手中紧握着玉佩..."
  }
}

生成分镜时，线索的 clue_sheet 会自动作为参考图传入 API。

related-skills.json

같은 저장소

generate-script.md

from "ArcReel/cc-novel2video"

使用 Gemini API 生成 JSON 剧本。使用场景：(1) 用户运行 /generate-script 命令，(2) 已完成 Step 1/2 需要生成最终剧本。读取 step1_segments.md 和 project.json，调用 gemini-3-flash-preview 生成符合 Pydantic 模型的 JSON 剧本。

2026-02-0610

generate-characters.md

from "ArcReel/cc-novel2video"

使用 Gemini 图像生成 API 为视频生成人物设计图。使用场景：(1) 用户需要为项目生成人物参考图，(2) 用户运行 /generate-characters 命令，(3) 剧本中有人物没有 character_sheet 路径。生成一致的人物设计用于分镜和视频生成。

2026-02-0610

generate-storyboard.md

from "ArcReel/cc-novel2video"

使用 Gemini 图像 API 生成分镜图。说书模式直接生成分镜图，剧集动画模式使用两步流程。使用场景：(1) 用户运行 /generate-storyboard 命令，(2) 剧本中有场景没有分镜图，(3) 用户想在视频生成前预览场景。

2026-02-0610

generate-video.md

from "ArcReel/cc-novel2video"

使用 Veo 3.1 API 为每个场景独立生成视频片段，以分镜图作为起始帧，然后使用 ffmpeg 拼接。使用场景：(1) 用户运行 /generate-video 命令，(2) 剧本中有场景没有 video_clip 路径，(3) 用户想将分镜图转换为视频。

2026-02-0610

manga-workflow.md

from "ArcReel/cc-novel2video"

完整的端到端工作流程，将小说转换为视频。使用场景：(1) 用户运行 /manga-workflow 命令，(2) 用户想开始新的视频项目，(3) 用户想继续现有项目。按顺序编排所有其他 skill，并在每个阶段设置审核检查点。

2026-02-0310

compose-video.md

from "ArcReel/cc-novel2video"

使用 ffmpeg 进行视频后期处理。使用场景：(1) 用户运行 /compose-video 命令，(2) 需要添加背景音乐、片头片尾，(3) 需要合并多个 episode 的视频。主要用于后期处理，视频连贯性由 generate-video 的连续模式保证。

2026-01-2610

package.json

"author": "ArcReel"

"repository": "ArcReel/cc-novel2video"

GitHub 저장소 열기 Creator 저장소 보기

$ install --global

$ download --local

Manus에서 실행

$ useful --forSOC

소프트웨어 개발자컴퓨터 및 수학직15-1252L4

name	generate-clues
description	使用 Gemini 图像生成 API 为视频生成线索设计图。使用场景：(1) 用户需要为项目生成线索参考图，(2) 用户运行 /generate-clues 命令，(3) project.json 中有 importance='major' 的线索没有 clue_sheet 路径。生成一致的线索设计用于分镜和视频生成。

生成线索设计图

使用 Gemini 3 Pro Image API 创建线索设计图，确保整个视频中重要物品和环境的视觉一致性。

Prompt 最佳实践

在编写线索描述和生成 Prompt 前，请先阅读 docs/nano-banana.md 第 365 行起的 Prompting guide and strategies 章节，了解 Gemini 图像生成的最佳实践。

核心原则：

"Describe the scene, don't just list keywords. A narrative, descriptive paragraph will almost always produce a better, more coherent image than a list of disconnected words."

线索描述编写指南

道具类（prop）

编写道具 description 时，请遵循叙事式写法：

✅ 推荐:

"一块翠绿色的祖传玉佩，约拇指大小，玉质温润透亮。表面雕刻着精致的莲花纹样，花瓣层层舒展，中心有一枚小小的莲蓬。玉佩上系着一根红色丝绳，打着传统的中国结。"

❌ 避免:

"玉佩，绿色，莲花纹，红绳"

环境类（location）

编写环境 description 时，同样使用叙事式：

✅ 推荐:

"村口的百年老槐树，树干粗壮需三人合抱，树皮龟裂沧桑。主干上有一道明显的雷击焦痕，从顶部蜿蜒而下。树冠茂密，夏日里洒下斑驳的树影。"

❌ 避免:

"老槐树，大，有雷击痕"

要点:

用连贯段落描述形态、质感、细节
包含材质、颜色、尺寸、特征
突出能在不同场景中识别的独特特征

概述

线索（clues）是需要在多个场景中保持一致的重要元素，包括：

道具类（prop）：信物、武器、信件、首饰等关键物品
环境类（location）：标志性建筑、特定树木、重要场所等

工作流程

加载项目元数据
- 如未指定项目名称，询问用户
- 从 projects/{项目名}/project.json 加载项目数据
- 列出 importance='major' 且没有 clue_sheet 的线索
生成线索设计
- 对于每个待生成的线索：
  - 根据类型（prop/location）选择对应的 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

Prompt 模板

道具类（prop）

一张专业的道具设计参考图，{项目 style}。

道具「[名称]」的多视角展示。[详细描述 - 叙事式段落]

三个视图水平排列在纯净浅灰背景上：左侧正面全视图、中间45度侧视图展示立体感、右侧关键细节特写。柔和均匀的摄影棚照明，高清质感，色彩准确。

环境类（location）

一张专业的场景设计参考图，{项目 style}。

标志性场景「[名称]」的视觉参考。[详细描述 - 叙事式段落]

主画面占据四分之三区域展示环境整体外观与氛围，右下角小图为细节特写。柔和自然光线。

API 使用

使用 lib/gemini_client.py：

from lib.gemini_client import GeminiClient

client = GeminiClient()
image = client.generate_image(
    prompt=clue_prompt,
    aspect_ratio="16:9",
    output_path=f"projects/{项目名}/clues/{线索名}.png"
)

质量检查清单

道具类

批准道具设计前检查：

三个视角清晰一致
细节符合描述（颜色、材质、尺寸）
特殊标记或纹理清晰可见
整体风格与项目一致

环境类

批准环境设计前检查：

整体构图符合描述
标志性特征突出
光线和氛围合适
细节图清晰可辨

线索管理

添加新线索

在 Claude 对话中添加线索：

请为项目添加一个新线索：
- 名称：玉佩
- 类型：prop
- 描述：一块翠绿色的祖传玉佩，约拇指大小，雕刻着莲花纹样，系着红色丝绳
- 重要程度：major

或直接编辑 project.json：

{
  "clues": {
    "玉佩": {
      "type": "prop",
      "description": "一块翠绿色的祖传玉佩，约拇指大小，雕刻着莲花纹样，系着红色丝绳",
      "importance": "major",
      "clue_sheet": ""
    }
  }
}

在场景中使用线索

在剧本的场景中添加 clues_in_scene 字段：

{
  "scene_id": "E1S3",
  "characters_in_scene": ["姜月茴"],
  "clues_in_scene": ["玉佩", "老槐树"],
  "visual": {
    "description": "姜月茴站在老槐树下，手中紧握着玉佩..."
  }
}

生成分镜时，线索的 clue_sheet 会自动作为参考图传入 API。

generate-clues

生成线索设计图

Prompt 最佳实践

线索描述编写指南

道具类（prop）

环境类（location）

概述

工作流程

命令格式

Prompt 模板

道具类（prop）

环境类（location）

API 使用

质量检查清单

道具类

环境类

线索管理

添加新线索

在场景中使用线索

이 저장소의 다른 Skills

이 저장소의 다른 Skills

生成线索设计图

Prompt 最佳实践

线索描述编写指南

道具类（prop）

环境类（location）

概述

工作流程

命令格式

Prompt 模板

道具类（prop）

环境类（location）

API 使用

质量检查清单

道具类

环境类

线索管理

添加新线索

在场景中使用线索