Community寫作與編輯github.com

腳本審查

在本地瀏覽器頁面上逐行審閱影片腳本,可對行或選取文字添加註解、直接編輯行,並將筆記發送回代理程式以修訂 Markdown 檔案。

腳本審查 是什麼?

此技能提供了一個完整的本地瀏覽器工作流程,用於審查影片腳本(以 Markdown 檔案呈現)。審閱者可以逐行閱讀腳本,對特定行或選取的文字添加註解,直接編輯行內容,最後將所有筆記一鍵發送回 AI 代理程式。代理程式收到筆記後,會根據註解最小幅度地修改原始腳本檔案,並且瀏覽器頁面會自動重新載入並標記變更處。此技能支援 Claude Code 等具備檔案操作和執行本機命令能力的 AI 代理平台,透過 Python 3.9+ 腳本驅動,無需安裝第三方套件。審閱循環包括:儲存腳本、啟動頁面、等待筆記、套用修改,直到審閱者發送「Looks good.」訊息表示批准。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kjmagnan1s/reviewing-scripts/tree/main/skills/reviewing-scripts

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

腳本審查 是做什麼的?

每個腳本都是一個 Markdown 檔案。審閱者在本地頁面上閱讀,他們的反饋會以 Markdown 形式回傳給你。所有命令皆使用 python3 scripts/script_review.py <command>,路徑相對於此技能所在的資料夾。需要 Python 3.9 或更新版本,無需安裝任何套件。

審閱循環

  1. 儲存腳本。 將腳本內容寫入一個暫存檔,然後執行 script_review.py new --title "<標題>" --body-file <檔案> --status drafted。它會印出腳本的 ID、檔案路徑和頁面位址。在每一行放置一個句子或一個鏡頭節拍,以便每行可以有自己的註解。
  2. 啟動頁面。 執行 script_review.py up,然後執行 script_review.py open <id>。將位址提供給審閱者。
  3. 等待筆記。 在背景執行 script_review.py wait <id>。當審閱者點擊 傳送筆記 時,它會印出筆記;如果兩小時後仍無傳送,則以代碼 2 退出。
  4. 套用筆記。 以最小變更編輯腳本檔案,回應每一則筆記。開啟的頁面會自動重新載入,並標記已變更的行。
  5. 從步驟 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。

相關技能