脚本审阅 是做什么的?
每个脚本是一个 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 重复,直到笔记显示“看起来不错。” 这次发送还会将草稿状态改为已批准。
如果你在发送笔记时没有等待,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。