スクリプトのレビュー
各スクリプトは1つのマークダウンファイルです。レビュアーはローカルページでスクリプトを読み、そのフィードバックはマークダウン形式でユーザーに返されます。すべてのコマンドは python3 scripts/script_review.py <コマンド> で実行し、パスはこのスキルのフォルダからの相対パスです。Python 3.9以降が必要で、インストールするパッケージはありません。
レビューループ
- スクリプトを保存します。 本文を一時ファイルに書き込み、
script_review.py new --title "<タイトル>" --body-file <ファイル> --status draftedを実行します。スクリプトのID、ファイルパス、ページアドレスが表示されます。各行に1つの文またはビートを配置し、各行が個別にコメントを受け取れるようにします。 - ページを起動します。
script_review.py upを実行し、続けてscript_review.py open <ID>を実行します。レビュアーにアドレスを伝えます。 - フィードバックを待ちます。 バックグラウンドで
script_review.py wait <ID>を実行します。レビュアーが Send notes をクリックすると、フィードバックが表示されます。2時間経過しても送信がない場合はコード2で終了します。 - フィードバックを適用します。 各フィードバックに応える最小限の変更でスクリプトファイルを編集します。開いているページは自動的にリロードされ、変更された行にマークが付きます。
- フィードバックが「Looks good.」になるまでステップ3から繰り返します。 その送信により、ドラフトは承認ステータスに移行します。
フィードバック送信時に待機していなかった場合は、script_review.py inbox で未読のフィードバックセットがすべて表示されます。
修正ルール
- レビュアーの編集は一字一句保持します。 「edits (already saved to the file)」の下にリストされた行はレビュアー自身の文言で、フィードバックを確認する前にファイルに反映されています。フィードバックで要求された場合のみ変更します。
- フィードバックが対象とする部分だけを変更します。 コメントのない行は書き換えません。
- 「Edits that didn't land」は手動で適用します。 送信前にその行が移動したため、ファイルは変更されていません。
- 自分で設定していないフロントマターのキーはそのままにします。 ステータスは
script_review.py status <ID> <ステータス>で変更し、ファイルを直接編集しないでください。 - レビュアーが依頼しない限り、スクリプトファイルを削除しないでください。
ファイル形式
---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---
## Spoken Script
Your first line, one sentence per line.
The second line.
## Alternate hooks
Hook 2 (question): A second opening line to film.
## Caption
Anything else you keep with the script.
Copy read はページ上で Spoken Script セクションを1段落としてコピーし、次に各代替フックを「Two. <行>」としてフック2から順にコピーします。Spoken Script セクションがないファイルは全体が読み上げられます。script_review.py read <ID> は同じテキストを表示します。
その他のコマンド
list [--status <ステータス>] [--json]: すべてのスクリプトとそのステータス、単語数を表示します。status <ID> <ステータス>: ステータスを設定します(デフォルト:idea、drafted、ready、filmed、posted)。config: 使用中の設定と設定ファイルのパスを表示します。down: ページサーバーを停止します。
設定(フォルダ、ポート、セクション名、ステータス、レビュアー名)およびTailscaleによるスマホアクセスについては、リポジトリルートのREADMEを参照してください。