Révision des scripts
Chaque script est un fichier Markdown. Le relecteur le lit sur une page locale et ses retours vous parviennent en Markdown. Toutes les commandes sont python3 scripts/script_review.py <commande>, avec le chemin relatif au dossier de cette compétence. Python 3.9 ou plus, aucun paquet à installer.
La boucle de révision
- Sauvegarder le script. Écrivez le corps dans un fichier temporaire et exécutez
script_review.py new --title "<titre>" --body-file <fichier> --status drafted. Cela affiche l'identifiant du script, le chemin du fichier et l'adresse de la page. Mettez une phrase ou un temps (beat) sur chaque ligne de la lecture, afin que chaque ligne puisse avoir son propre commentaire. - Lancer la page. Exécutez
script_review.py up, puisscript_review.py open <id>. Donnez l'adresse au relecteur. - Attendre les notes. Exécutez
script_review.py wait <id>en arrière-plan. Il affiche les notes lorsque le relecteur clique sur Envoyer les notes, et se termine avec le code 2 après deux heures sans envoi. - Appliquer les notes. Modifiez le fichier du script avec le plus petit changement qui répond à chaque note. La page ouverte se recharge et marque les lignes modifiées.
- Répéter à partir de l'étape 3 jusqu'à ce que les notes disent "Looks good." Cet envoi fait également passer un brouillon au statut approuvé.
Si vous n'étiez pas en attente lorsque les notes ont été envoyées, script_review.py inbox affiche chaque ensemble non lu.
Règles de révision
- Conservez les modifications du relecteur mot pour mot. Les lignes listées sous "edits (already saved to the file)" sont leur propre formulation et se trouvent dans le fichier avant que vous voyiez les notes. Ne modifiez une ligne que lorsqu'une note vous le demande.
- Modifiez uniquement ce qu'une note couvre. Ne réécrivez pas les lignes qui n'ont aucun commentaire.
- Appliquez "Edits that didn't land" manuellement. La ligne a été déplacée avant l'envoi, donc le fichier n'a pas été modifié.
- Laissez les clés de frontmatter que vous n'avez pas définies. Changez le statut avec
script_review.py status <id> <status>, pas en modifiant le fichier. - Ne supprimez pas un fichier de script sauf si le relecteur le demande.
Le format du fichier
---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---
## Script parlé
Votre première ligne, une phrase par ligne.
La deuxième ligne.
## Accroches alternatives
Accroche 2 (question) : Une deuxième ligne d'ouverture à filmer.
## Légende
Tout ce que vous gardez avec le script.
Copie à lire sur la page copie la section Script parlé sous forme d'un paragraphe, puis chaque accroche
alternative à partir de l'accroche 2 sous forme de "Deux. ". Un fichier sans section Script parlé est
entièrement lu. script_review.py read <id> affiche le même texte.
Autres commandes
list [--status <status>] [--json]: chaque script avec son statut et son nombre de mots.status <id> <status>: définit un statut (idea,drafted,ready,filmed,postedpar défaut).config: les paramètres utilisés et le chemin du fichier de configuration.down: arrête le serveur de pages.
Les paramètres (dossiers, port, noms de sections, statuts, nom du relecteur) et l'accès téléphone via Tailscale sont décrits dans le README à la racine du dépôt.