# Jianying Script To Draft

> 把参考视频或带时间码的短视频脚本、本地素材库和旁白音频编排成可在剪映专业版继续编辑的自包含草稿。适用于电商带货、产品科普、营销混剪和批量短视频；覆盖拆镜、素材盘点与匹配、配音对齐、时间线生成和安全登记。macOS 11.2 已验证，Windows 支持草稿生成但需首次人工打开验证。不用于 ChatCut、BGM 创作、字幕样式微调、电影级原创剪辑、最终导出或发布。

- Skill: `skychentian/jianying-script-to-draft` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add skychentian/jianying-script-to-draft`
- Raw SKILL.md: https://api.skillmd.com/api/skills/skychentian/jianying-script-to-draft/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: skychentian (https://skillmd.com/u/skychentian)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/skychentian/jianying-script-to-draft

---


# 剪映脚本成片草稿

## 脚本路径

把本文件所在目录记为 `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

1. 明确输入：参考视频和/或时间轴脚本、素材目录、旁白文案或音频、草稿名称与目标剪映根目录。默认竖屏 `1080x1920`、`30fps`，用户设置优先。
2. 创建独立工作目录，原素材只读。先运行 `${SKILL_DIR}/scripts/inspect_assets.py`；零字节、损坏和重复文件只记入清单，不删除、不移动。
3. 有参考视频时运行 `${SKILL_DIR}/scripts/analyze_reference.py`，得到镜头边界、关键帧和参考音轨；无参考视频时按 `references/job-schema.md` 把用户的时间表标准化为 `recipe.json`。
4. 读取 `references/prompt-library.md`，完成逐镜头意图、搜索词和素材匹配。连续三镜避免来自同一源；置信度低于 `0.60` 标记 `缺素材`。
5. 需要新旁白时，优先使用运行环境中已安装的 TTS Skill；若没有可用 TTS，则请用户提供旁白音频。只有音效、多音色或克隆场景才使用支持这些能力的语音工具。任何计费生成都先遵守对应工具的确认门禁。用真实音频时长更新镜头节奏。
6. 把最终视觉、旁白、基础字幕和标题编译成 `job.json`。字幕只做可编辑的基础样式，不在本 Skill 内做字号审美微调；不加 BGM。
7. 先用 `${SKILL_DIR}/scripts/build_jianying_draft.py --validate-only` 校验，再正式生成自包含草稿。
8. 根据系统处理草稿发现：macOS 11.2 可在确认剪映已关闭后运行 `${SKILL_DIR}/scripts/register_jianying_draft.py` 登记到首页；Windows 优先把草稿直接生成到用户在剪映设置中确认的草稿根目录，重启剪映刷新。只有用户接受实验性索引写入时才运行登记脚本，并先 `--dry-run`；失败则按 `references/jianying-11.2-notes.md` 使用“找回草稿”。
9. 验证草稿目录、素材路径、轨道数量、总时长与登记结果。只有实际在剪映中打开过，才表述为“已打开验证”；否则表述为“结构校验通过，待人工打开”。

## 硬门禁

- 不删除、移动、覆盖用户原素材；所有入草稿素材必须复制。
- 不把账号、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`
- 只在对应阶段运行脚本，不要为“更完整”加载无关报告。