export-premiere
Skill4 starsChanged 2 months agoMITView on GitHub
Use when timeline.json exists and the user asks to export the rough cut or an editable handoff packet to Premiere Pro.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- analyze-footageSkill
- build-blueprintSkill
- compile-timelineSkill
- crop-photosSkill
- design-intentSkill
- evaluate-editSkill
- finish-business-shortSkill
- finish-creator-shortSkill
- finish-interviewSkill
- full-pipelineSkill
- import-premiereSkill
- re-editSkill
- render-videoSkill
- review-roughcutSkill
- select-clipsSkill
- select-photosSkill
- setup-environmentSkill
- short-sound-designSkill
- troubleshoot-errorSkill
- vertical-social-compositionSkill
- vertical-social-platform-deliverySkill
The file
Files
export-premiere
いつ使うか
- 「Premiere に出して」「XML を書き出して」と言われたとき。
05_timeline/timeline.jsonを外部 NLE で詰めたいとき。
前提条件
timeline.jsonと asset ごとの media path が必要。- 実務上は XML単体ではなく、XML・注釈・review・preview/final mediaを束ねた editor packet を既定にする。
- Studioで見えている完成状態を渡す場合、先に playback contract が
exactであることを確認する。
やること(ステップ)
- playback contract と packet readiness を確認する。
swift run --package-path apps/macos-studio videoos-studio-cli playback-contract-status <project-id>
swift run --package-path apps/macos-studio videoos-studio-cli handoff-packet-status <project-id>asset_id -> absolute file pathの source map JSON を用意する。自動解決できない場合だけ明示mapを使う。
{
"AST_31A9CDC2": "/absolute/path/to/file.MOV"
}- editor packet をエクスポートし、manifestを検証する。
swift run --package-path apps/macos-studio videoos-studio-cli handoff-export-packet <project-id>
swift run --package-path apps/macos-studio videoos-studio-cli handoff-packet-verify <project-id>- XML単体が必要な場合だけ従来CLIを使う。
npx tsx scripts/export-premiere-xml.ts projects/<project> --source-map /absolute/path/to/source-map.jsonvideo clip に metadata.zoom / crop / position / render.effects が宣言されている場合、まず非破壊 preflight を行う。
node_modules/.bin/tsx scripts/export-premiere-xml.ts projects/<project> --preflight --jsonbake_required は exit 2 であり、元映像を未処理のまま書き出してはならない。rights が operator_declared_ok|licensed、privacy が operator_declared_ok で、source-ledger / source-map / source-media-manifest / live file が一意に一致する場合だけ、明示 consent で video-only bake を生成する。
node_modules/.bin/tsx scripts/export-premiere-xml.ts projects/<project> --bake-visual-effects --json固定 cache は 09_output/premiere-bakes、export authority は 09_output/premiere-exports/CURRENT.json。bake は H.264 CRF 14 near-lossless、BT.709 limited、single-thread、bframes=0 で、effect_editable:false の非編集可能な derived media。output-root override はない。canonical audio は元 source の独立 clipitem を維持する。
timeline.tracks.overlay の全クリップはXML生成前に検査する。現在登録済みのcanonical presetはmotion/font/layout/shadow/stroke/accent/panel/background/safe-area等の必須semanticsを持ち、Outline Textでは正確に表現できないため、構造化style errorでXML/receipt書込み前に停止する。登録済みplain-title exact routeは現在ない。caption trackはtitleに変換しない。
simple transition は crossfade を正確な Cross Dissolve、match_cut_bridge / match_cut を正確な Dip to Color としてのみ出力する。fade_to_black を Cross Dissolve に置換しない。transition ID と track 上の隣接 endpoint は一意、duration は明示的な正の整数、alignment は center、window は両隣 clip のtimeline区間内でなければ、XML/receipt書込み前に構造化エラーで停止する。source handle authority は生成せず、profile は report_only のままにする。
- packet内の XML を Premiere Pro で
File -> Importする。字幕が有効な案件では caption sidecar と承認artifactも編集者へ渡す。
出力 artifact
09_output/<project_id>_premiere.xml09_output/<project_id>_premiere.roundtrip.json(XMLと同時生成されるapply用receipt)09_output/editor_packet/manifest.json09_output/editor_packet/media/*
注意事項
- script の auto-resolve は
03_analysis/内の top-level JSON にあるasset_idとsource_pathを探す。canonical なassets.json.items[]は直接見ないので、assets.jsonだけでは足りないことが多い。 - source map が 0 件だと export は失敗する。
- 形式は Premiere 向け FCP7 XML。
- XMLをPremiereへ渡すときは、同時生成された
.roundtrip.jsonも保持する。同じrawtimeline.jsonからの再exportでは同じroundtrip_idになる。 - canonical overlayがある場合、legacy
--titles/--auto-titlesは重複titleを避けるため、解決結果が空でも書込み前に失敗する。 - canonical titleは全required semanticsがOutline Text parametersで表現できるpresetだけが対象であり、現在は該当presetがない。警告劣化やlegacy titleへの置換は行わない。
- packet verifyが通っても playback contractがstaleなら完成状態の保証にはならない。両方を確認する。
- 字幕有効時は packet manifest に
caption_sidecarとcaption_approvalが含まれることを確認する。欠けていればpackage後にpacketを再exportする。 - synthetic fixture の成功は Premiere hardware proof ではなく、simple transition profile を昇格させない。
- bake manifest/index/receipt v2/READY が全て一致しても
hardware_verified:falseのままであり、editable effect、human approval、rights clearance、Premiere実機証明を主張しない。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

