screenwriting-refactor

Files (2)

• SKILL.md
• refactor-rules.md · references/

SKILL.md (first lines)

# Screenwriting Refactor

在编剧理论约束下重构故事结构，确保变更不破坏核心戏剧原则。

## 流程

### Step 1: 读取当前状态

1. 读取 `wiki/meta/logline.md` — 理解核心前提
2. 读取 `wiki/beats/` — 获取当前 15-beat 结构
3. 读取 `wiki/characters/` — 获取角色设定
4. 读取 `wiki/meta/genre.md` — 理解类型约束

### Step 2: 分析重构方向

根据用户指令判断重构类型：

| 类型 | 示例指令 | 影响范围 |
|------|----------|----------|
| 类型转换 | "调整为心理惊悚" | beats + 部分角色 |
| 结构强化 | "加强 B Story" | 特定 beats |
| 角色重塑 | "让反派更有深度" | 角色卡 + 关联 beats |
| 节奏调整 | "中段太拖" | beats 7-12 |
| 主题聚焦 | "主题不够清晰" | meta + theme-related beats |

### Step 3: 生成重构提案

按 `references/refactor-rules.md` 中的约束规则，生成：

1. **变更清单**: 哪些文件会被修改
2. **Diff 展示**: 每个文件的旧→新对比
3. **理论依据**: 为什么这样改（引用具体理论原则）
4. **风险评估**: 这个改动可能引入什么新问题

### Step 4: 确认与执行

1. 展示完整提案给用户
2. 等待用户确认（可以选择"全部接受"/"逐项确认"/"取消"）
3. 确认后批量写入修改
4. 在 `wiki/log.md` 追加重构记录（含 diff 摘要）

## 重构约束

完整规则见 `references/refactor-rules.md`。核心不可违反原则：

1. **15-beat 框架不可删减** — 可以调整内容，不能跳过 beat
2. **主角 Wants/Needs 张力必须保持** — 重构后两者仍需冲突
3. **Catalyst 外力性不可破坏** — 催化事件必须是外力而非主角自发
4. **弧光方向不可无理由逆转** — 除非明确是类型转换
5. **来源追溯不可断裂** — 新内容标注来源为"refactor"

## 输出示例

```
🔄 重构提案: "调整为心理惊悚"

影响范围: 9 个 beat + 2 个角色

--- wiki/beats/beat-01-开场画面.md ---
- 内容: 阳光明媚的小镇广场
+ 内容: 表面平静的小镇，但画面构图暗示不安（过于对称的房屋、过于整齐的草坪）

--- wiki/beats/beat-04-催化剂.md ---
- 内容: 收到一封工作邀请
+ 内容: 深夜目睹邻居在花园秘密掩埋什么东西

--- wiki/characters/小明.md ---
- opinions: 小镇生活很平静
+ opinions: 表面上觉得平静，但总有一种说不清的不安感

📝 理论依据:
- 心理惊悚的 Opening Image 需要"表面正常 + 微妙不安"的视觉暗示
- Catalyst 在惊悚类型中应是"发现了不应该发现的事"

⚠️ 风险: B Story 可能需要相应调整以承载"信任vs怀疑"主题

确认应用？(y/全部接受 | n/取消 | p/逐项确认)
```

From e06084/claude-screenwriting, MIT.

More from e06084/claude-screenwriting