Cinematic Script Writer

核心用法

Cinematic Script Writer 是一款面向AI视频生成工作流的专业剧本创作CLI工具。用户通过npm install -g openclaw-skills安装后，可执行完整的影视创作流程：

故事构建：create-context建立时代背景（如"Ancient India/Ramayana Era"），generate-ideas批量生成故事概念，create-script输出完整剧本。

摄影数据库：内置可查询的机位角度（11种）、运镜方式（10种）、景别类型（9种）、布光方案（10种）及调色风格（5种）参考库，支持suggest-camera/lighting/grading智能推荐。

角色系统：create-character-ref生成视觉参考表，create-voice建立对话声线档案，validate-prompt自动检测时代错位（anachronism）。

生产输出：自动生成7文件项目结构（含剧本、图片提示词、角色指南、YouTube元数据），支持Google Drive OAuth2同步或本地存储，可导出Markdown/JSON/纯文本。

显著优点

• AI工具原生设计：提示词格式直接适配Midjourney、Sora、Veo、Runway等主流工具，区分静态图片与动态视频提示词
• 强一致性保障：每次生成强制携带角色完整视觉描述，时代验证机制避免穿帮（如古代场景出现现代物品）
• 完整制片文档：输出结构模仿专业影视流程，INDEX+README+PROMPTS+REFS+VOICE+META+CONTEXT的7文件体系可直接交付制作团队
• 多模态集成：集叙事创作、视觉设计、声音指导、平台分发于一体，覆盖从创意到发布的全链路

局限性与风险

• CLI门槛：纯命令行交互，无GUI界面，对非技术用户不够友好
• Google Drive依赖：云存储功能需外部OAuth2授权，存在隐私顾虑且国内网络环境可能受限
• 时代准确性边界：anachronism检测依赖内置数据库，小众历史场景或架空世界观可能误报/漏检
• AI提示词过拟合：输出格式针对特定AI工具优化，若目标平台更新语法可能需手动调整

适合人群

AI视频创作者（YouTuber、独立动画人）、Midjourney/Sora重度用户、短视频MCN编导、需要快速产出视觉一致系列内容的制作者。

常规风险

存储功能涉及Google OAuth2凭证内存管理，虽声明"securely stored"但无开源审计报告；脚本输出依赖用户主动验证历史准确性，自动化检测仅为辅助。

核心用法

Cinematic Script Writer 是一款面向 AI 视频生成时代的专业脚本创作工具，通过 CLI 交互实现从故事构思到生产级输出的全流程覆盖。用户首先通过 create-context 建立包含时代背景、角色设定的故事宇宙，随后可调用 generate-ideas 批量生成带转折钩子（hook & twist）的故事概念，最终通过 create-script 输出包含完整镜头调度、布光方案、色彩分级的专业电影脚本。

工具内置三大核心数据库：镜头角度库（Camera Angles）、运镜运动库（Camera Movements）、景别库（Shot Types）以及照明技术（Lighting Techniques）与调色风格（Color Grading）参考表，用户可通过 suggest-camera、suggest-lighting 等命令获取与情感意图匹配的专业建议。针对 AI 视频生成的特殊需求，工具提供角色一致性表（Character Reference Sheets）与声线档案（Voice Profiles）功能，确保跨场景视觉与对话风格的统一。

输出层面，工具自动生成适配 Midjourney、Sora、Veo、Runway 等平台的结构化图像/视频提示词，并支持导出 Markdown、JSON、纯文本三种格式。通过 connect-drive 或 connect-local 可将完整项目（含脚本、提示词、角色指南、YouTube 元数据）归档存储。

显著优点

1. 专业镜头语言数据库：内置 10 种基础镜头角度、10 种运镜方式、9 种景别的情感映射表（如低角度表现权力感、俯拍呈现脆弱性），以及 10 种照明技术与 6 种调色风格指南，大幅降低创作者的专业门槛。

2. AI 工作流深度适配：针对生成式 AI 的特性设计输出格式，自动将脚本转换为带 [Shot type][Camera angle][Lighting][Color grading] 标签的结构化提示词，并附带时代准确性校验（Anachronism Detection），避免 AI 生成时代错位的视觉元素。

3. 角色一致性系统：通过可视化参考表（Visual Reference）与声线档案（Voice Profile）双重机制，确保同一角色在多场景中的外观、性格、说话方式保持连贯，解决 AI 视频创作中角色"变脸"的核心痛点。

4. 生产就绪输出：项目自动打包为 7 文件结构（索引、可读脚本、图像提示词、角色指南、声线指南、YouTube 元数据、背景信息），可直接交付制作团队执行，无需二次整理。

5. 权限与隐私设计合理：Google Drive 集成采用 OAuth2 认证，令牌仅内存存储；所有创作数据默认本地处理，无外泄至 Skill 作者服务器。

潜在缺点与局限性

1. 依赖外部存储服务：Google Drive 功能需用户自行配置 OAuth 环境变量（GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET），对非技术用户存在配置门槛；本地存储仅支持下载目录，缺乏自定义路径选项。

2. 时代数据库覆盖有限：Anachronism Detection 功能依赖内置的时代风格指南，对于非主流历史时期或架空世界观可能校验能力不足。

3. CLI 交互门槛：纯命令行界面要求用户熟悉终端操作，无图形界面或 Web 端，对习惯可视化创作工具的用户不够友好。

4. 生成质量依赖底层 AI：故事创意生成（generate-ideas）与脚本创作（create-script）依赖外部 LLM，工具本身仅提供结构化封装，创意上限受限于模型能力。

5. 网络行为单一：除 Google Drive 外无其他云存储选项（如 Dropbox、OneDrive、AWS S3），生态锁定风险。

适合的目标群体

• AI 视频创作者：使用 Midjourney 生成分镜、Sora/Veo/Runway 生成动态视频的内容生产者
• 独立短片导演/编剧：需要快速产出可执行拍摄方案，但缺乏专业摄影指导资源的个人创作者
• 动画与游戏预演团队：需统一角色视觉与场景风格的 3D 动画、独立游戏开发项目
• YouTube 内容运营者：需要批量生成带 SEO 元数据的视频脚本与配套图像提示
• 影视教育机构：作为镜头语言与剧本结构的入门教学辅助工具

使用风险

• 性能风险：大型项目（多角色、长脚本）可能在内存中累积较多状态数据，建议在长会话中定期保存并清理上下文
• 依赖风险：仅依赖 uuid@9.0.0，供应链攻击面极小，但需确保 package-lock.json 被锁定以固定版本
• 令牌泄露风险：Google OAuth 访问令牌虽内存存储，但用户需避免在日志级别为 DEBUG 的环境中运行，防止敏感信息意外输出
• 时代准确性误报：Anachronism Detection 基于规则匹配，可能出现误判或漏判，关键历史题材建议人工复核
• 存储权限依赖：Google Drive 功能需申请 http:request 权限，在企业内网或代理环境下可能受限