Skripte prüfen
Jedes Skript ist eine Markdown-Datei. Der Prüfer liest es auf einer lokalen Seite, und seine Notizen kommen als Markdown zu Ihnen zurück. Alle Befehle lauten python3 scripts/script_review.py <befehl>, mit dem Pfad relativ zu diesem Skill-Ordner. Python 3.9 oder höher, keine Pakete müssen installiert werden.
Der Prüfzyklus
- Skript speichern. Schreiben Sie den Inhalt in eine temporäre Datei und führen Sie
script_review.py new --titel "<titel>" --datei-pfad <datei> --status entworfenaus. Es gibt die ID des Skripts, den Dateipfad und die Seitenadresse aus. Setzen Sie einen Satz oder einen Takt pro Zeile, damit jede Zeile einen eigenen Kommentar erhalten kann. - Seite starten. Führen Sie
script_review.py hochund dannscript_review.py öffnen <id>aus. Geben Sie dem Prüfer die Adresse. - Auf Notizen warten. Führen Sie
script_review.py warten <id>im Hintergrund aus. Es gibt die Notizen aus, wenn der Prüfer auf Notizen senden klickt, und beendet sich nach zwei Stunden ohne Sendung mit Code 2. - Notizen anwenden. Bearbeiten Sie die Skriptdatei mit der kleinstmöglichen Änderung, die jede Notiz beantwortet. Die offene Seite lädt sich selbst neu und markiert die geänderten Zeilen.
- Wiederholen Sie Schritt 3, bis die Notizen „Sieht gut aus“ sagen. Dieses Senden versetzt ein Skript außerdem vom Status „entworfen“ in „fertig“.
Wenn Sie nicht gewartet haben, als Notizen gesendet wurden, gibt script_review.py posteingang alle ungelesenen Sets aus.
Regeln für die Überarbeitung
- Behalten Sie die Änderungen des Prüfers wortwörtlich bei. Zeilen, die unter „Änderungen (bereits in Datei gespeichert)“ aufgeführt sind, stammen vom Prüfer und sind bereits in der Datei, bevor Sie die Notizen sehen. Ändern Sie sie nur, wenn eine Notiz Sie dazu auffordert.
- Ändern Sie nur das, was eine Notiz abdeckt. Schreiben Sie keine Zeilen um, die keinen Kommentar haben.
- Wenden Sie „Änderungen, die nicht landeten“ manuell an. Die Zeile wurde vor dem Senden verschoben, sodass die Datei nicht geändert wurde.
- Lassen Sie Frontmatter-Schlüssel, die Sie nicht gesetzt haben, unverändert. Ändern Sie den Status mit
script_review.py status <id> <status>, nicht durch Bearbeiten der Datei. - Löschen Sie keine Skriptdatei, es sei denn, der Prüfer bittet darum.
Das Dateiformat
---
type: script
id: 2026-01-15-drei-eingabe-gewohnheiten
titel: Drei Eingabegewohnheiten
status: entworfen
---
## Gesprochenes Skript
Ihre erste Zeile, ein Satz pro Zeile.
Die zweite Zeile.
## Alternative Einstiege
Einstieg 2 (Frage): Eine zweite Eröffnungszeile zum Filmen.
## Untertitel
Alles andere, was Sie zum Skript behalten.
Vorlesekopie auf der Seite kopiert den Abschnitt „Gesprochenes Skript“ als einen Absatz, dann jeden alternativen Einstieg ab Einstieg 2 als „Zwei. “. Eine Datei ohne Abschnitt „Gesprochenes Skript“ wird komplett vorgelesen. script_review.py lesen <id> gibt denselben Text aus.
Weitere Befehle
liste [--status <status>] [--json]: jedes Skript mit seinem Status und der Wortanzahl.status <id> <status>: einen Status setzen (standardmäßigidee,entworfen,bereit,gefilmt,veröffentlicht).konfig: die verwendeten Einstellungen und der Pfad der Konfigurationsdatei.runter: den Seitenserver anhalten.
Einstellungen (Ordner, Port, Abschnittsnamen, Stati, Name des Prüfers) und Telefonzugriff über Tailscale sind in der README im Repository-Stammverzeichnis beschrieben.