编译时间线

📌 Skill基础信息

• Skill名称: compile-timeline
• 简称: 时间线编译工具
• 来源: 社区第三方 (mocchalera)
• 运行宿主: 仅能在支持 bash 命令执行的 Agent 工具中运行（如 Claude-Code CLI、Cursor 等）
• 核心定位: 在视频编辑项目中，当编辑蓝图和候选选择文件准备就绪时，自动编译生成时间线配置文件和相关清单文件

🧩 内部核心组成

该 Skill 主要包含以下核心组件：

核心处理脚本:

• scripts/compile-timeline.ts - 主编译脚本，负责时间线生成和验证

文件模式识别:

• 自动识别 **/05_timeline/timeline.json
• 自动识别 **/05_timeline/preview-manifest.json
• 自动识别 **/05_timeline/adjacency_analysis.json

命令功能:

命令模式	功能简述
标准编译模式	根据编辑蓝图生成完整时间线配置
Patch 应用模式	应用评审补丁并重新生成时间线

🛠 安装与启用方式

安装命令:

skills install --user mocchalera/video-os-v2

前置依赖:

• Node.js 运行环境
• TypeScript 执行环境 (tsx)
• 项目目录结构符合规范

启动命令:

npx tsx scripts/compile-timeline.ts projects/<project> --fps 30

Patch 模式启动:

npx tsx scripts/compile-timeline.ts projects/<project> --patch projects/<project>/06_review/review_patch.json --fps 30

📋 标准工作流

1. 输入检查: 验证 creative_brief.yaml, selects_candidates.yaml, edit_blueprint.yaml 文件存在且完整
2. 阻塞检查: 检查 01_intent/unresolved_blockers.yaml 中是否存在状态为 blocker 的项
3. 编译执行: 运行编译脚本生成时间线配置文件
4. 输出生成: 创建 timeline.json, preview-manifest.json 及可选的 adjacency_analysis.json
5. 验证确认: 输出文件验证和状态确认

⚠️ 关键限制、缺陷、注意事项

平台限制:

• 仅支持具有 Node.js 环境的开发平台
• 需要特定的项目目录结构规范

Token 消耗: 【无公开信息】

项目适配性:

• 适合: 结构化视频编辑工作流项目
• 不适合: 非标准项目结构或简单视频编辑需求

已知坑点:

• FPS 默认值为 24，需要时必须显式指定 --fps 参数
• 时间线更新后需要重新渲染以确保播放状态准确
• 不能手动编辑 manifest hash 来标记旧预览为新鲜状态

生产环境适用性: 可用于生产环境，但需要完整的项目规范遵循

✅ 适用场景 & ❌ 不适合场景

适用场景:

• 专业视频编辑工作流自动化
• 需要生成标准化时间线配置的项目
• 有评审补丁需要应用的时间线更新场景
• 结构化视频制作项目管理

不适合场景:

• 简单的视频剪辑需求
• 非结构化或临时性视频项目
• 不需要自动化时间线生成的场景
• 项目目录结构不符合规范的情况

skills install --user mocchalera/video-os-v2