capcut-draft-editinglisted

# CapCut Draft Editing (agent skill) Production-tested workflow for driving CapCut desktop from code: generate complete projects from an edit list, lay out vertical phone footage professionally, and make surgical changes to existing drafts without destroying manual work. ## Architecture that works 1. **Edit list as data** — one TSV (`rough-segments.tsv`) describes the whole timeline. Every user revision = edit one line + regenerate (30s). Never hand-edit segment JSON for authoring; regenerate wholesale. 2. **Generator** — `bin/generate_draft.py` (pyCapCut) rebuilds the draft from the TSV. Keep it IN THE PROJECT FOLDER (session temp dirs get wiped between sessions). 3. **Envelope transplant** — modern CapCut ignores pycapcut's `draft_content.json`. After `script.save()`, merge your content keys into a `draft_info.json` envelope copied from any draft the user's CapCut created natively (a "donor"). See the generator's final block. 4. **Manual-finish mode** — the moment the user starts editing in the CapCut UI, STOP regenerating (it wipes their edits). Switch to surgical JSON edits (`bin/ripple_cut.py`) or replace referenced media files in place (same path = CapCut reloads content). ## TSV row grammar (tab-separated) ``` V <event-dir> <clip-name> <src-start> <dur> [label] # video P <event-dir> <photo-name> 0 <dur> [label] # photo (Ken Burns kf + snapshot fx) 3 <event-dir> a@s;b@s;p:c@L 0