MUST USE when source footage or a material folder is provided and material understanding or 03_analysis generation is needed. Trigger not only on explicit analysis requests ('分析して', '素材を見て') but also when the user points at footage and says things like 'この動画で', 'この素材で', or any request that requires understanding the provided media before planning or editing.
compile-timeline
Use when edit_blueprint.yaml and selects_candidates.yaml are ready and the user asks to compile the rough cut, generate timeline.json, or apply a review patch.
含まれるファイル(1)
- SKILL.md3.1 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
compile-timeline
いつ使うか
- 「コンパイルして」「タイムラインを生成して」と言われたとき。
creative_brief.yaml,selects_candidates.yaml,edit_blueprint.yamlが揃っているとき。
前提条件
scripts/compile-timeline.tsは compile 前後でscripts/validate-schemas.ts相当の gate を見る。01_intent/unresolved_blockers.yamlにstatus: blockerがあると compile gate が落ちる。- fps を 24 以外にしたい場合は
--fps <num>を明示する。
やること(ステップ)
- 必要 artifact が存在することを確認する。
- compile を実行する。
npx tsx scripts/compile-timeline.ts projects/<project> --fps 30
- review patch を適用したい場合は patch mode を使う。
npx tsx scripts/compile-timeline.ts projects/<project> --patch projects/<project>/06_review/review_patch.json --fps 30
- 出力された
timeline.json、preview-manifest.json、必要ならadjacency_analysis.jsonを確認する。 - 既存preview/finalがある状態でtimelineを更新した場合、それらをfreshとみなさない。Studio確認前にrenderを再実行し、
playback-contract-statusがexactであることを確認する。
出力 artifact
05_timeline/timeline.json05_timeline/preview-manifest.json05_timeline/adjacency_analysis.jsonただし active editing skills による transition 解析が走った場合
注意事項
scripts/compile-timeline.tsのcreatedAtは01_intent/creative_brief.yaml.created_atから決まる。- patch mode は
timeline.jsonを上書きし、同時にpreview-manifest.jsonも再生成する。 - manifest hashだけを手編集して古いpreviewをfresh扱いにしない。
adjacency_analysis.jsonは debug / explanation 用 artifact。常に生成されるわけではない。- Rhythm Sync (Issue #35):
03_analysis/bgm_analysis.json(onset/downbeat/sections)と楽曲アセットの word-level STT(03_analysis/transcripts/TR_<music_asset>.jsonのitems[].words[])をリズム証拠として、サビ/ブレイク開始のカット境界を ±1.5秒探索で1フレーム精度スナップする(サビは第一声・ダウンビート優先の Hard Snap)。証拠が無い/曖昧な場合は fail-open でtimeline.metadata.rhythm_syncにstatus: degradedと理由を明示し、クリップのジオメトリは変更しない。スナップ後はintegrity.gap_frames/overrun_frames = 0を検証し、parity(±2フレーム、サビ頭違反は fail)をtimeline.metadata.rhythm_syncとpreview-manifest.json.rhythm_syncの両方へ刻印する。無効化はruntime/compiler-defaults.yamlのrhythm_sync.mode: off。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
Use when selects_candidates.yaml exists and the user asks to design structure, build an edit blueprint, or create 04_plan/edit_blueprint.yaml.
日本語の概要は準備中です。原文の説明を表示しています。
MUST USE when the user asks to crop, reframe, trim, or improve composition of still photos, especially selected event photos, album photos, portraits, speakers, panels, workshops, or group photos. Use after photo selection or correction when the task is composition improvement rather than selecting images.
日本語の概要は準備中です。原文の説明を表示しています。
MUST USE when starting a new video project, when the user provides footage and asks to edit/create a video, or when 01_intent/creative_brief.yaml does not yet exist. This skill interviews the user to understand their intent before any editing begins. Never skip this step.
日本語の概要は準備中です。原文の説明を表示しています。
Use after changing prompts, skills, the compiler, or editorial policies — or when the user asks to measure edit quality, run regression evals, check agreement with approved edits, or says '評価して', '一致率を測って', 'eval を回して'. Compares agent output against human-approved golden projects.
Use when timeline.json exists and the user asks to export the rough cut or an editable handoff packet to Premiere Pro.
日本語の概要は準備中です。原文の説明を表示しています。