agentleFS
e06084e06084/claude-screenwriting/skills/screenwriting-refactor/SKILL.md

screenwriting-refactor

Skill9 starsChanged 6 months agoMITView on GitHub

在编剧理论约束下重构故事结构。读取当前 wiki,生成带 diff 的重构提案, 用户确认后写入变更。支持类型转换、结构强化、角色重塑等。 Triggers on: "/screenwriting-refactor", "重构", "调整结构", "restructure".

The file

Files
SKILL.md

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/逐项确认)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.