AI Video Asset Manager

AI视频制作资产管理体系。负责角色/场景/道具资产的创建、锁定、版本管理，镜头分镜规划，生成记录归档，一致性检查，返工记录。触发词：新角色、新场景、新镜头、拍视频、建资产、锁定资产、一致性检查、生成记录、返工记录、小弯开拍。当需要管理AI视频生成资产，或为新角色/场景建立资产卡时激活。

Security Scan

The skill's files and runtime instructions are coherent with an AI video asset management workflow; included scripts perform local project initialization and user-driven downloads and do not request unrelated credentials or hidden network endpoints.

Purpose & Capability

Name/description (asset/cards/consistency checks) match the provided SKILL.md, reference documents, and the two helper scripts. References to Runway/Kling/Veo are explanatory (supported tools) but no connectors or credentials are requested — reasonable for an instruction-first asset-management skill.

Instruction Scope

SKILL.md instructs the agent to create and read local asset files, run consistency checks, and download reference images from user-provided URLs. Reading/writing project files and performing consistency checks is expected; however the '下载素材 [URL]' action and the batch-download script allow fetching arbitrary URLs supplied by users — this is functional but requires care (see guidance).

Install Mechanism

No install spec is provided (instruction-only). Two small Python scripts are bundled; they are plain, readable, and do not fetch remote code or perform installation steps. No archives or external downloads during install.

Credentials

No environment variables, credentials, or config paths are requested. The skill does not ask for unrelated secrets or elevated access — credential requests are proportional (none).

Persistence & Privilege

Skill is not always-enabled and does not claim to modify other skills or system-wide agent settings. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.

Assessment

This skill appears internally consistent and the bundled scripts are straightforward. Before installing or running: 1) Only use trusted URLs with the '下载素材' command — the batch-download script will save whatever bytes are at those URLs to disk and could store malicious files. 2) Run the skill in a workspace you control (not a sensitive system directory) because it creates and reads local project files. 3) If you expect automatic integration with Runway/Kling/Veo, note the skill documents workflows but does not include API connectors or require credentials — you'll need to manage any tool-specific auth separately. 4) If you plan to let the agent act autonomously, be aware it will read and write project files and may download user-specified resources; restrict access to only the directories you want it to manage.

基于 ViMax 多智能体视频生成框架思路，适配 Runway/Kling/可灵/即梦/Pika/Sora/Veo 等工具。

核心原则

1. 资产优先 — 角色/场景/道具未锁定不开始生成
2. 版本不覆盖 — 每次变更新建版本号
3. 检查前置 — 一致性检查是进入下一镜头的门槛

命名规范

类型	前缀	示例
角色	CHAR_	CHAR_001_小弯
场景	SCENE_	SCENE_001_游戏房
道具	PROP_	PROP_001
镜头	SHOT_	SHOT_001_01
口播模板	TPL_	TPL_001
参考图	REF_	REF_CHAR_001_front_v01
生成记录	GEN_	GEN_001
一致性检查	CHECK_	CHECK_001
返工记录	RW_	RW_001

资产状态机

草稿 → 审核中 → 已锁定 → 使用中 → 已废弃
  ↑                      ↓
  ← ← ← ← ← ← ← 返工 ← ←

项目结构

每个项目独立仓库：

[项目名]/
├── 00_总览.md
├── 01_资产库/
│   ├── 角色/         # CHAR_XXX_名字.md
│   ├── 场景/         # SCENE_XXX_名字.md
│   └── 道具/         # PROP_XXX_名字.md
├── 02_分镜/
│   ├── 00_分镜表_模板.md
│   └── SHOT_XXX_XX.md
├── 03_参考图索引/
│   ├── CHAR_XXX/
│   ├── SCENE_XXX/
│   ├── TPL_XXX/
│   └── SHOT_XXX/
├── 04_生成记录/
│   └── GEN_XXX_描述.md
├── 05_一致性检查/
│   └── CHECK_XXX_镜头ID.md
└── 06_返工记录/
    └── RW_XXX_镜头ID.md

工作流

新建角色资产

1. 用户提供：角色名 + 外观描述（至少：发型、服装、性格）
2. 创建 01_资产库/角色/CHAR_XXX_名字.md
3. 建立 03_参考图索引/CHAR_XXX/ 目录
4. 用户提供或抓取参考图 URL → 下载到本地
5. 填写外观锁定项、可/禁用提示词
6. 状态：草稿

锁定资产

条件：角色外观经过 ≥2 次生成验证

1. 确认外观锁定项全部勾选
2. 将 frontmatter 中 status 改为 已锁定
3. 在版本历史中新增条目

新建镜头

1. 确认关联角色/场景已锁定
2. 创建 02_分镜/SHOT_XXX_XX.md
3. 绑定资产引用（角色ID、场景ID、道具ID）
4. 填写分镜信息（镜头号、叙事位置、景别、动作描述）
5. 状态：草稿

生成记录归档

1. 用户提供：使用的工具（Runway/Kling/Veo等）
2. 创建/更新 04_生成记录/GEN_XXX_描述.md
3. 记录：prompt、参数、产出路径、工具
4. 状态：已完成

一致性检查

按 references/consistency-rules.md 检查：

检查项	通过标准
角色外观	与 CHAR_XXX.md 外观锁定项一致
场景	与 SCENE_XXX.md 一致
道具	与道具资产卡一致
表情/姿态	在表情库/手势库范围内
光线/色调	保持一致

全部通过 → 镜头卡标记 ✅
有任一项不一致 → 进入返工流程

返工记录

1. 创建 06_返工记录/RW_XXX_镜头ID.md
2. 记录：返工原因、不一致项、修复方案
3. 修复后重新通过一致性检查

常用指令

用户说	执行
新角色 [名字] [描述]	新建角色资产卡
新场景 [名字] [描述]	新建场景资产卡
锁定 [资产ID]	将资产状态改为已锁定
新镜头 [角色ID] [场景ID]	新建镜头卡
生成记录 [镜头ID] [工具]	引导填写生成参数
一致性检查 [镜头ID]	执行一致性检查
返工 [镜头ID]	创建返工记录
下载素材 [URL]	下载图片到本地目录

项目初始化

新项目运行 scripts/init-project.py：

python scripts/init-project.py [项目路径] [项目名]

参考：references/project-templates.md