audio-transcript-cut-planning

name	audio-transcript-cut-planning
description	Use when turning word-level ASR into safe text-based cuts: filler words, 语气词, 口癖, repeated phrases, long silences, caption cleanup, padding, crossfades, and reviewable cut plans.

Transcript Cut Planning

Use this skill after ASR has produced word-level timestamps. It produces a cut plan, caption projection, and optionally a new non-destructive rendered video asset.

For Clash's current local planner:

clash production plan-text-cut \
  --transcript analysis/transcripts/words.json \
  --target-asset asset-talk \
  --out actions/talking-head-text-cut.json \
  --json

Then review the action JSON and run clash production apply-metadata to emit metadata and caption timeline projections. The caption projection uses caption items with cue wordIds, source frame ranges, wordRefs, and sourceToOutputMap. Do not mutate canvas/timeline state without the explicit CAS apply step. The transcript JSON may include backendId, modelId, language, durationFrames, and averageConfidence; plan-text-cut records the transcript file path/hash and those ASR fields in talking-head.analysis.

After review, create a media cut package or ffprobe-validated rendered clean clip. export-text-cut-media --render refuses to render while the action still has review cuts; export without --render first when you need a package that lists pending reviewRanges.

clash production export-text-cut-media \
  --action actions/talking-head-text-cut.json \
  --source-asset asset-talk \
  --output-asset asset-talk-clean \
  --out assets/video/asset-talk-clean.mp4 \
  --assets assets/manifest.json \
  --render \
  --json

clash production export-captions \
  --timeline projections/timelines/asset-talk.caption.timeline.yaml \
  --format vtt \
  --out exports/captions/asset-talk-clean.vtt \
  --json

clash production project-caption-overlay \
  --timeline projections/timelines/asset-talk.caption.timeline.yaml \
  --out projections/timelines/asset-talk.caption-overlay.timeline.yaml \
  --json

clash production export-timeline-handoff \
  --timeline projections/timelines/asset-talk.caption.timeline.yaml \
  --format csv \
  --out exports/handoff/asset-talk-clean.timeline.csv \
  --json

Input Contract

analysis/transcripts/words.json
media/source.mp4

Each word should include id, text, startFrame, and endFrame. Words may also include confidence and speakerId; transcript-level provenance can include backend/model/language and average confidence.

Output Contract

actions/talking-head-text-cut.json
projections/metadata/<asset-id>.talking-head.analysis.json
projections/transcripts/<asset-id>.asr-transcript.json
projections/media-cuts/<asset-id>.transcript-cut-plan.json
projections/timelines/<asset-id>.caption.timeline.yaml
projections/timelines/<asset-id>.caption-overlay.timeline.yaml
projections/media-cuts/<output-asset-id>.media-cut.json
projections/media-cuts/<output-asset-id>.ffconcat
assets/video/<output-asset-id>.mp4
exports/captions/<output-asset-id>.srt
exports/captions/<output-asset-id>.vtt
exports/handoff/<output-asset-id>.timeline.csv
reviews/cut-plan-review.md

Rules

• subtitle-only mode is allowed without video cuts.
• Audio/video cuts require word timestamps.
• Do not delete discourse markers that carry meaning.
• Every proposed deletion needs reason, confidence, and preview metadata.
• Filler words and word-gap silences may be automatic delete suggestions; tone-particle and adjacent-repeat suggestions are review cuts by default.
• Source media remains immutable; apply creates a new timeline/clip/export.
• Plain text clips are allowed for overlays but do not count as a structured caption system;字幕 projections should be caption items.
• Use clash production export-captions when the user needs SRT/VTT/ASS sidecars for review, upload, or ad delivery.
• Use clash production project-caption-overlay when the caption timeline needs an explicit CAS-required subtitle overlay projection for preview/apply.
• Use clash production export-timeline-handoff when a human editor or external NLE needs a CSV timeline review sheet.
• Rendered text-cut media must be registered as a new asset with source lineage.
• Do not render pending review cuts; approve, remove, or rewrite them before creating a rendered media asset.

Cut Reasons

Use a controlled reason value:

• silence
• filler
• tone-particle
• repeat
• false-start
• manual

Safety

Aggressive mode requires explicit review. Conservative mode may auto-propose but still should not directly overwrite any source asset.