Community写作与编辑github.com

脚本审阅

在本地浏览器页面中逐行审阅视频脚本,对行或选中的词语添加评论、直接编辑行,并将笔记发送回智能体以修改 Markdown 文件。适用于用户想要在浏览器中审阅、评论或批准脚本草稿、询问脚本页面或脚本列表、希望在手机或提词器上查看脚本,或草拟脚本后需要审阅的场景。

脚本审阅 是什么?

此技能专为需要审阅视频脚本的用户设计,提供了一个本地浏览器界面,让审阅者能够逐行阅读脚本、添加评论、直接编辑行,并将笔记发送回 AI 智能体。智能体随后根据笔记自动修改脚本文件。该技能基于 Python 3.9+,无需安装额外包,通过 `script_review.py` 命令管理整个流程:创建脚本、启动页面、等待审阅笔记、应用修改,并支持循环审阅直到批准。支持多种命令如列表、状态修改、配置查看等,并可通过 Tailscale 实现手机访问。它主要适用于开发者、内容创作者或任何需要协作审阅脚本的场景,确保脚本质量并高效管理修订过程。

兼容平台~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 重复,直到笔记显示“看起来不错。” 这次发送还会将草稿状态改为已批准。

如果你在发送笔记时没有等待,script_review.py inbox 会打印所有未读的笔记集合。

修订规则

  • 原封不动保留审阅者的编辑。 列在“编辑(已保存到文件)”下的行是审阅者自己的措辞,并且在你看笔记之前已经存在于文件中。只有当笔记要求时,才更改某一行。
  • 只修改笔记涵盖的内容。 不要重写没有评论的行。
  • 手动应用“未生效的编辑”。 该行在发送前已移动,因此文件没有被更改。
  • 保留你未设置的前置元数据键。 使用 script_review.py status <id> <status> 更改状态,而不是编辑文件。
  • 不要删除脚本文件,除非审阅者要求。

文件格式

---
type: script
id: 2026-01-15-three-prompt-habits
title: Three prompt habits
status: drafted
---

## 口语脚本

第一行,每行一个句子。
第二行。

## 备用钩子

钩子2(问题):一个备用的开场拍摄行。

## 字幕

你随脚本保留的其他任何内容。

复制朗读 在页面上将“口语脚本”部分复制为一个段落,然后从钩子2开始将每个备用钩子复制为“二. <行>”。没有“口语脚本”部分的文件将全部被朗读。script_review.py read <id> 打印相同的文本。

其他命令

  • list [--status <状态>] [--json]:列出所有脚本及其状态和字数。
  • status <id> <状态>:设置状态(默认为 idea、drafted、ready、filmed、posted)。
  • config:显示当前使用的设置和配置文件路径。
  • down:停止页面服务器。

设置(文件夹、端口、章节名称、状态、审阅者姓名)以及通过 Tailscale 实现手机访问的说明,请参阅仓库根目录下的 README。

相关技能