/screenwriting-beats — 节拍表管理

用法

/screenwriting-beats              — 概览 15-beat 表格
/screenwriting-beats catalyst     — 深入查看某个 beat
/screenwriting-beats generate     — AI 生成完整 beat 表草稿
/screenwriting-beats validate     — 校验类型承诺是否兑现

概览输出格式

Beat 名称映射

generate — AI 生成 Beat 表

前置条件

生成 beat 表必须基于已有的：

1. wiki/meta/genre.md — 确定类型引擎（必须存在）
2. wiki/meta/logline.md — 确定故事前提（必须存在）
3. wiki/meta/theme.md — 确定主题（建议存在）
4. wiki/characters/ — 确定角色表（必须至少有 hero）

如果这些前置内容不存在，提示用户先完成 Stage 1 和 Stage 2：

⚠️ 生成 beat 表需要先完成:
  - [ ] Meta 定位 (genre + logline + theme)  → /screenwriting-reimagine 或手动创建
  - [ ] 角色设计 (至少 hero)                 → /screenwriting-character new

生成流程

1. 读取 genre → 查 references/genre-constraints.md 获取该类型的 beat 约束
2. 读取角色表 → 基于角色 wants/needs/arc 分配角色到各 beat
3. 生成 15 beat 内容：
   • content: 具体事件/情节（非抽象结构说明）
   • emotion: 情绪走向
   • conflict: 冲突描述
   • value_shift: 价值从X到Y
   • characters_involved: 涉及角色名
4. 校验类型承诺（见下方 validate）
5. 展示完整 beat 表给用户确认
6. 确认后写入 wiki/beats/ + 更新 wiki/故事线.canvas

类型引擎驱动

每种 genre 的 beat 有特定功能要求（摘要）：

完整约束见 references/genre-constraints.md。

validate — 类型承诺校验

读取当前 beats + genre，逐条检查：

类型承诺校验 (genre: 推理侦探):

  ✅ Beat 4: 谜题出现 — "监控录像中出现不可能的影子"
  ✅ Beat 8: 线索拼图 — "三条线索指向同一个人，但动机不成立"
  ⚠️ Beat 9: 应有方向转折 — 当前内容缺乏关键线索揭示
  ✅ Beat 11: 侦探被牵入 — "翟发现自己的指纹出现在案发现场"
  ✅ Beat 14: 揭露+代价 — "真相大白但友情破裂"

  通过: 4/5 | 建议调整 Beat 9

行为细节

无参数（概览）

1. 读取 wiki/beats/ 下所有 beat 文件
2. 输出 15-beat 表格
3. 标注缺失的 beat 和建议

指定 beat（深入）

1. 读取对应 beat 文件完整内容
2. 显示当前内容 + 类型约束提醒
3. 如内容为空，引导填写

generate（AI 生成）

见上方详细流程。

validate（校验）

见上方详细流程。

理论参考

• references/theory-save-the-cat.md — 15 beats 定义 + 10 大类型
• references/genre-constraints.md — 各类型对 beats 的具体约束