skychentian 剪映脚本成片草稿
脚本路径
把本文件所在目录记为 SKILL_DIR。运行脚本时使用 ${SKILL_DIR}/scripts/<script>.py，不要假设当前工作目录就是 Skill 目录。
Output Contract
交付一个能在剪映专业版 11.2 中继续编辑的草稿目录。草稿必须自包含所用素材，并附 recipe.json、asset_inventory.json、matches.json、job.json、generation_manifest.json；素材不足时改交 missing_assets.json，不要拿无关镜头硬填。macOS 11.2 已完成真实草稿生成验证；Windows 支持素材处理与草稿生成，但未完成真实剪映打开验收，必须明确标记“待 Windows 人工打开验证”。
Workflow
- 明确输入：参考视频和/或时间轴脚本、素材目录、旁白文案或音频、草稿名称与目标剪映根目录。默认竖屏
1080x1920、30fps，用户设置优先。 - 创建独立工作目录，原素材只读。先运行
${SKILL_DIR}/scripts/inspect_assets.py；零字节、损坏和重复文件只记入清单，不删除、不移动。 - 有参考视频时运行
${SKILL_DIR}/scripts/analyze_reference.py，得到镜头边界、关键帧和参考音轨；无参考视频时按references/job-schema.md把用户的时间表标准化为recipe.json。 - 读取
references/prompt-library.md，完成逐镜头意图、搜索词和素材匹配。连续三镜避免来自同一源；置信度低于0.60标记缺素材。 - 需要新旁白时，优先使用运行环境中已安装的 TTS Skill；若没有可用 TTS，则请用户提供旁白音频。只有音效、多音色或克隆场景才使用支持这些能力的语音工具。任何计费生成都先遵守对应工具的确认门禁。用真实音频时长更新镜头节奏。
- 把最终视觉、旁白、基础字幕和标题编译成
job.json。字幕只做可编辑的基础样式，不在本 Skill 内做字号审美微调；不加 BGM。 - 先用
${SKILL_DIR}/scripts/build_jianying_draft.py --validate-only校验，再正式生成自包含草稿。 - 根据系统处理草稿发现：macOS 11.2 可在确认剪映已关闭后运行
${SKILL_DIR}/scripts/register_jianying_draft.py登记到首页；Windows 优先把草稿直接生成到用户在剪映设置中确认的草稿根目录，重启剪映刷新。只有用户接受实验性索引写入时才运行登记脚本，并先--dry-run；失败则按references/jianying-11.2-notes.md使用“找回草稿”。 - 验证草稿目录、素材路径、轨道数量、总时长与登记结果。只有实际在剪映中打开过，才表述为“已打开验证”；否则表述为“结构校验通过，待人工打开”。
硬门禁
- 不删除、移动、覆盖用户原素材；所有入草稿素材必须复制。
- 不把账号、API Key、音色凭证或付费接口参数写进 Skill、日志或
job.json。 - 不猜素材路径、镜头语义或品牌事实；缺证据就显式留缺口。
- 生成前检查绝对路径、媒体可读性、时间段非负、视频源区间不越界、ID 唯一。
- 登记前备份
root_meta_info.json，并拒绝在剪映运行时直接修改索引。
资源路由
- 输入/输出字段：
references/job-schema.md - 从文章工作流抽象出的通用提示词：
references/prompt-library.md - 剪映 11.2、Windows/macOS 兼容与恢复：
references/jianying-11.2-notes.md - 发布与路由边界：
evals/trigger_cases.json、evals/semantic_config.json - 只在对应阶段运行脚本，不要为“更完整”加载无关报告。