Couper les erreurs et répétitions (Agent de pipeline 2)
Deuxième étape du montage automatisé, à exécuter après cut-silences. Elle supprime ce qu'un monteur humain couperait lors d'un second passage : bégaiements (« le le », « j- j- »), mots immédiatement répétés, faux départs (phrase abandonnée et recommencée), et reprises (ligne réenregistrée — garder la prise propre, jeter la ratée).
Décider ce qui constitue une erreur relève du jugement, pas d'une formule — une répétition emphatique (« jamais, jamais ») et un dédoublement rhétorique (« le premier morceau est, est-ce que… ») ressemblent mécaniquement à un bégaiement. Par défaut, cet agent est donc soumis à validation : il présente des coupes candidates avec leur contexte complet ; l'agent (et l'utilisateur) décident ; seules les coupes approuvées sont rendues.
Quand l'utiliser
- « coupe les erreurs », « supprime les bégaiements / répétitions », « nettoie les cafouillages », « garde la meilleure prise », « coupe les faux départs »
- Comme deuxième étape du workflow de montage principal, sur la sortie de cut-silences.
Le flux en trois parties
1. Trouver les candidates (mécanique)
node .agents/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
<silence-transcript.json> --out-dir video-projects/<slug>/assets
L'entrée est normalement le <stem>.silence-transcript.json de l'Agent 1, de sorte que les coupes tombent sur la timeline déjà silencée. Écrit :
<stem>.cut-candidates.json— candidates structurées (type, confiance, plagecutproposée, texteremoves/keeps, contexte, recommandation)<stem>.cut-candidates.md— proposition lisible
Types de candidates : stutter (répétition immédiate d'un mot), retake (segment dupliqué/quasi-dupliqué via similarité de Jaccard), false_start (courte phrase abandonnée qui redémarre).
2. Validation (le verrou — OBLIGATOIRE)
Lisez chaque candidate dans son contexte et décidez de la garder ou de la couper. Le détecteur mécanique ne peut pas distinguer une répétition intentionnelle/d'une vraie erreur, donc ne faites pas aveuglément confiance à recommend — lisez removes + context. Faux positifs courants : répétition emphatique (« ce n'est jamais, jamais sans intervention »), copule puis question (« le morceau est, est-ce que… »), énumérations.
Présentez les candidates à l'utilisateur avec une recommandation par élément ; recueillez les approbations. Écrivez les coupes approuvées dans un fichier :
{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "faux départ J-" }, ... ] }
(start/end en secondes sur la timeline vidéo/transcription d'entrée. Vous pouvez élargir la plage d'une candidate — par exemple pour une reprise, couper du début de la prise ratée jusqu'au redémarrage propre.)
3. Appliquer les coupes approuvées
node .agents/skills/cut-mistakes/scripts/apply-cuts.mjs \
<silence-transcript.json> --cuts approved-cuts.json \
--video video-projects/<slug>/assets/edited-silenced.mp4 \
--output video-projects/<slug>/assets/edited-clean.mp4 --apply
Écrit l'EDL, une transcription ré-échelonnée <stem>.mistakes-transcript.json (alimente l'agent graphismes animés + validate-beat-sync.mjs), un journal des décisions, et — avec --apply — la vidéo coupée (trim+concat ffmpeg, A/V synchronisé). Omettez --apply pour un essai à blanc.
Réviser le résultat
Utilisez l'outil de révision partagé pour inspecter les coupes et vérifier les limites :
node scripts/build-edl-review.mjs <stem>.mistakes-edl.json \
--original video-projects/<slug>/assets/edited-silenced.mp4 \
--edited video-projects/<slug>/assets/edited-clean.mp4 \
--output video-projects/<slug>/assets/mistakes-review.html
npx serve . -p 8080 -n
Remarques
- Un enregistrement très propre peut donner peu ou pas de coupes réelles — c'est un résultat valide ; ne coupez pas la parole naturelle pour atteindre un quota.
- Les coupes entre deux mots parlés sont des jonctions dures. Elles sont généralement propres pour les bégaiements/faux départs ; pour un audio plus serré, un fondu de 20 à 30 ms peut être ajouté ultérieurement.
- Transmettez le
mistakes-transcript.json+ la vidéo nettoyée à l'Agent 3 (graphismes animés / cartes hiérarchisées).