SuperAPI AI 工具集

mc-new

设计与创作

查看项目

更新于 10-29 20:17

技能介绍

mc-new 是一个项目初始化技能,用于从格式配置(format profile)搭建视频项目骨架,供后续各阶段技能统一使用。

用途:在 {projects-path}/<slug>/ 下创建项目目录,生成 project.json 与 brief.md。project.json 是后续下游技能在没有本次对话上下文的情况下读取的项目约定,因此创建时阶段列表、模式与入口点必须正确;brief.md 记录创作者自己的表述及创意来源链接,这些信息后续无法补回。

主要能力:

  • 解析路径规则:裸路径相对 {video-path}(即 {projects-path}/<slug>/ 下的当前视频项目)解析;{skill-root} 指向本技能安装目录;{project-root} 指向项目工作目录。
  • 激活时加载 studio 配置(通过 resolve_config.py 读取 modules.manticore),为空表示 mc-setup 尚未运行,应停止并引导创作者前往。
  • 区分两种入口:创意优先(默认)从头脑风暴开始跑完整流程,任何格式配置均可用;素材优先(素材已存在,如直播录像或录制演讲)完全跳过构思,在创建时把源文件登记到 project.json 的 sources 中,下一步进入剪辑,且必须使用不含构思阶段的格式配置(如 livestream-vod);若 studio 没有此类配置,应引导创作者到 mc-setup 添加,而非强行使用构思型配置。
  • 收集项目 slug(kebab-case)、格式({formats-path}/ 下的配置)、工作标题,素材优先时还需源文件绝对路径;并主动询问两个创作者通常不会主动说明的问题:是否为某个系列的一集(系列集位于系列文件夹中,旁边有共享的 common/ 存放常青素材,该布局在创建时固定),以及是否有外部事件截止日期(会议、发布等;真实日期进入截止模式,下游阶段会限制迭代循环以优先保证交付;愿景性日期不算截止日期,应留空)。
  • 执行 new_project.py 创建项目,并按需附加参数:--parent 用于从长视频派生的短片,--series 用于系列集,--deadline YYYY-MM-DD 用于事件驱动的项目,--ingest 用于素材优先(必要时配合 --source-id 与 --source-role primary|interview|screen)。
  • 当 [editor] name 解析为 Resolve 时,还会打开以 slug 命名的 Resolve 项目(通过 resolve_project.py 及预设),已存在的项目会被复用且不会重新应用预设;空预设表示使用 Resolve 默认设置创建并需说明;退出码 1 表示需修复的问题(预设不存在或 Resolve 中有其他项目占用),退出码 4 表示 Resolve Studio 不可达,应说明并继续,因为剪辑阶段稍后会创建项目。
  • 填写 brief.md:仅使用创作者提供的内容,不得编造;内容单薄时应主动询问。创意优先时记录其原话表述的创意、为何是现在、源材料链接;素材优先时记录素材是什么、成片应成为什么、已知重要片段。
  • 交接:报告创建的项目,并按 project.json 中 stage 指定的技能路由,不得假设主阶段列表。

使用方式:先确认入口类型,收集必要信息并回答系列与截止日期问题,然后运行 uv run {skill-root}/scripts/new_project.py <slug> --format <format> --title "<title>" --projects-dir {projects-path} --formats-dir {formats-path},按需附加上述参数。

适用场景:启动新视频项目、从录像剪辑视频、为直播 VOD 建立项目、为系列节目创建单集等。

限制与检查项:new_project.py 在 slug 或系列非 kebab-case、项目路径已存在、格式配置缺失或格式错误、--ingest 搭配含构思阶段的配置、素材文件缺失、截止日期非 ISO 格式时以非零码退出;brief.md 应使用创作者语言并链接回创意来源;deadline 若设置必须指向真实外部事件。