mcpField
F
fountain-syntax

fountain-syntax

github.com/bybren-llc创意与媒体7053 次安装12 周前更新
代码仓库

关于 fountain-syntax

面向 Fountain 剧本作者的语法参考技能，涵盖格式规则与校验要点，适用于编写、编辑和讲解 Fountain 文档。

主要功能

  1. 01标题页与场景标题语法
  2. 02角色、对白和括号说明
  3. 03文本格式、注释与归档内容
  4. 04剧本格式校验清单

适用场景

  1. 01编写或编辑 .fountain 文件
  2. 02检查剧本格式
  3. 03在格式间转换
  4. 04讲解 Fountain 语法

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bybren-llc/story-systems-template --skill fountain-syntax

安装后在 Claude Code 中输入/fountain-syntax确认已加载。

附带文件README.md

详细介绍

Fountain 语法技能

调用条件

在以下情况下应用此技能：

  • 编写或编辑 .fountain 文件
  • 验证剧本格式
  • 在不同格式之间转换
  • 教授 Fountain 语法

完整的 Fountain 语法参考

标题页

文档开头的键值对：

Title:
    **Seoul Identity**
Credit: Written by
Author: Scott Graham
Draft date: December 27, 2025
Contact: [email protected]

标准键：Title、Credit、Author、Source、Draft date、Contact、Copyright、Notes

场景标题
INT. COFFEE SHOP - DAY
EXT. MOUNTAIN ROAD - NIGHT
INT./EXT. CAR (MOVING) - CONTINUOUS

必须以以下内容开头：INT、EXT、EST、INT./EXT、INT/EXT 或 I/E 在任意行前加上 .，将其强制设为场景标题：

.FLASHBACK - TWENTY YEARS EARLIER

可选场景编号：

INT. HOUSE - DAY #1#
INT. HOUSE - DAY #1A#
动作（描述）

普通段落即为动作。保留换行。

The room is dark. A FIGURE moves in the shadows.

Sarah enters, hesitant. She looks around.

在全大写行前加上 !，将其强制设为动作：

!MONTAGE - SARAH'S MORNING ROUTINE
角色名

独占一行，全部大写；前面留空行：


SARAH
I don't understand.

带附加标记：

MOM (V.O.)
When I was your age...

JOHN (O.S.)
I'm in the kitchen!

SARAH (CONT'D)
And another thing...

使用 @ 强制保留大小写混排：

@McCLANE
Yippee ki-yay.
对白

角色名或括号说明后的文本：

JOHN
This is dialogue. It can span
multiple lines without a problem.
括号说明

放在括号中，位于角色名之后或对白之中：

SARAH
(looking away)
I never said that.
(beat)
Not exactly.
双人对白（同时说话）

在第二个角色名后加上 ^：

JACK
I love you!

JILL ^
I hate you!
转场

以 TO: 结尾的大写文本，或使用 > 强制指定：

CUT TO:

DISSOLVE TO:

>FADE TO BLACK.
居中文本

用 > 和 < 括起来：

>THE END<

>TITLE CARD: "THREE YEARS LATER"<
强调（格式）
*italics*
**bold**
***bold italics***
_underline_

使用反斜杠转义：\*not italic\*

歌词

加上前缀 ~：

~Somewhere over the rainbow
~Way up high
分页符

单独一行放置三个或更多 =：

===
注释（作者评论）

使用双方括号，不会出现在输出中：

[[This is a note to myself about the scene.]]
废弃内容区（归档内容）

/* 和 */ 之间的内容会被忽略：

/*
CUT SCENE - keeping for reference

INT. DINER - NIGHT
...
*/
章节（结构性内容，隐藏）

使用井号表示大纲层级：

# Act One
## Sequence 1
### Scene Group
梗概（场景摘要，隐藏）

加上前缀 =：

= Sarah discovers the truth about her father.

INT. SARAH'S APARTMENT - NIGHT

验证规则

必需元素
  • 标题页（完整剧本必需）
  • 带有地点和时间的场景标题
  • 正确的角色／对白结构
常见错误
  1. 角色名前缺少空行
  2. 场景标题缺少一天中的时间
  3. 括号说明未单独成行
  4. 特殊字符未转义，导致格式错误
语法验证清单
  • 标题页包含必需字段
  • 场景标题以 INT/EXT 开头
  • 角色名全部大写
  • 括号说明使用 (圆括号)
  • 双人对白正确使用 ^
  • 注释使用 [[双方括号]]
  • 废弃内容区正确使用 /* */

评论

支持 Markdown