腳本審查 是做什麼的?
每個腳本都是一個 Markdown 檔案。審閱者在本地頁面上閱讀,他們的反饋會以 Markdown 形式回傳給你。所有命令皆使用 python3 scripts/script_review.py <command>,路徑相對於此技能所在的資料夾。需要 Python 3.9 或更新版本,無需安裝任何套件。
審閱循環
- 儲存腳本。 將腳本內容寫入一個暫存檔,然後執行
script_review.py new --title "<標題>" --body-file <檔案> --status drafted。它會印出腳本的 ID、檔案路徑和頁面位址。在每一行放置一個句子或一個鏡頭節拍,以便每行可以有自己的註解。 - 啟動頁面。 執行
script_review.py up,然後執行script_review.py open <id>。將位址提供給審閱者。 - 等待筆記。 在背景執行
script_review.py wait <id>。當審閱者點擊 傳送筆記 時,它會印出筆記;如果兩小時後仍無傳送,則以代碼 2 退出。 - 套用筆記。 以最小變更編輯腳本檔案,回應每一則筆記。開啟的頁面會自動重新載入,並標記已變更的行。
- 從步驟 3 重複,直到筆記顯示「Looks good.」。這次傳送也會將草稿狀態變更為已批准。
如果你沒有在筆記傳送時處於等待狀態,可以執行 script_review.py inbox 來印出所有未讀的筆記組。
修訂規則
- 逐字保留審閱者的編輯。「edits (already saved to the file)」下的行是他們自己的措辭,並且在你看到筆記時已經存在於檔案中。僅在筆記要求時才更改。
- 僅修改筆記涵蓋的內容。 不要改寫沒有註解的行。
- 手動套用「Edits that didn't land」。 該行在傳送前已移動,因此檔案未被更改。
- 保留你未設定的 frontmatter 鍵。 使用
script_review.py status <id> <status>來更改狀態,不要直接編輯檔案。 - 不要刪除腳本檔案,除非審閱者要求。
檔案格式
---
type: script
id: 2026-01-15-three-prompt-habits
title: 三個提示習慣
status: drafted
---
## 口語腳本
第一行台詞,每行一個句子。
第二行。
## 替代開場
開場 2(提問):第二個開場台詞,用於拍攝。
## 字幕
任何你與腳本一起保存的其他內容。
Copy read 在頁面中會將「口語腳本」部分複製為一個段落,然後將每個從開場 2 開始的替代開場複製為「Two. <行>」。如果檔案沒有「口語腳本」部分,則整個檔案都會被朗讀。script_review.py read <id> 會印出相同的文字。
其他命令
list [--status <狀態>] [--json]:列出所有腳本及其狀態與字數。status <id> <狀態>:設定狀態(預設:idea,drafted,ready,filmed,posted)。config:顯示目前使用的設定及設定檔路徑。down:停止頁面伺服器。
設定(資料夾、連接埠、區段名稱、狀態、審閱者名稱)以及透過 Tailscale 的手機存取,詳見 repository 根目錄的 README。