Storyboard Manager

概览

Storyboard Manager 技能为 Claude 配备了专门知识和工具，用于创意写作工作流程。它提供了角色发展、故事结构模式、自动时间线跟踪和跨叙事项目的一致性检查框架。此技能自动适应各种故事板文件夹结构，同时保持小说、剧本和连载小说写作的最佳实践。

核心能力

该技能提供四个主要能力：

1. 角色发展与管理

支持创建具有背景故事、弧线和关系的深入、一致的角色档案。

2. 故事规划与结构

使用既定框架（三幕结构、英雄之旅、救猫等）指导情节发展，并帮助组织叙事元素。

3. 章节与场景写作

生成章节内容、场景细分和对话，保持与既定角色和情节的一致性。

4. 时间线跟踪与一致性检查

使用自动化工具验证时间顺序一致性、角色连续性和世界构建连贯性。

检测项目结构

Storyboard Manager 自动检测并适应各种文件夹组织。寻找这些常见的目录模式：

角色文件夹： characters/, Characters/, cast/, Cast/ 章节文件夹： chapters/, Chapters/, scenes/, Scenes/, story/ 规划文件夹： story-planning/, planning/, outline/, notes/ 摘要文件： summary.md, README.md, overview.md

当触发时，扫描项目根目录以识别结构并相应调整工作流程。如果不存在标准结构，则建议使用以下模式组织文件：characters/, chapters/, story-planning/, 和 summary.md。

工作流程决策树

使用此决策树确定适当的工作流程：

用户请求
├─ 角色相关？（“发展角色”，“创建背景故事”，“角色弧”）
│  └─ → 角色发展工作流程
│
├─ 规划/情节？（“概述故事”，“计划第二幕”，“情节结构”）
│  └─ → 故事规划工作流程
│
├─ 写作内容？（“写章节”，“生成场景”，“继续故事”）
│  └─ → 章节/场景写作工作流程
│
└─ 检查/分析？（“检查一致性”，“跟踪时间线”，“查找矛盾”）
   ├─ 时间线？ → 使用 timeline_tracker.py 脚本
   └─ 一致性？ → 使用 consistency_checker.py 脚本

角色发展工作流程

第 1 步：收集上下文

在发展角色之前，阅读现有角色文件以了解：

既定的命名约定和档案格式
现有角色和关系
故事类型和基调
已经使用的角色原型

使用 Read 工具检查角色目录中的现有角色文件。

第 2 步：访问角色发展框架

当需要详细的角色指导时，阅读 references/character_development.md，其中包含：

核心角色元素（个性、动机、目标）
背景故事框架（幽灵/伤口，形成关系）
角色弧类型（积极变化，平坦，消极）
关系动态
声音发展技巧
一致性指南

为了高效地找到特定指导，使用 Grep 搜索相关部分：

# 示例：查找角色弧的指导
grep -i "character arc" references/character_development.md

第 3 步：发展角色档案

创建或增强具有这些基本元素的角色档案：

基本信息

名字、年龄、角色、外貌
关键个性特征（正面和负面）

背景

起源和形成经历
幽灵/伤口塑造他们的行为
关键关系和家庭动态

角色弧

起始信念或缺陷
想要 vs. 需要（外部目标 vs. 内部成长）
转型之旅
结束状态

关系

与其他角色的联系
动态类型（盟友、对手、导师等）
关系如何演变

独特元素

能力、技能或特殊知识
秘密或隐藏方面
声音/语言模式
角色特定的怪癖

第 4 步：确保一致性

交叉参考：

现有角色档案（避免角色/特征的冗余）
故事规划文件（确保与情节需求一致）
摘要/概览（匹配类型和基调）

第 5 步：创建或更新文件

将角色档案写入 characters/[character-name].md 使用 markdown 格式。匹配其他角色文件中发现的风格和结构。

故事规划工作流程

第 1 步：评估当前规划状态

阅读现有规划文件以了解：

故事概念和前提
既定情节点或大纲
目标受众和类型
主题和中心问题
计划结构（如果有）

查看 story-planning/, outline/ 或 summary.md 等文件夹中的文件。

第 2 步：访问故事结构参考

需要详细的结构指导时，阅读 references/story_structures.md，包括：

三幕结构
英雄之旅（坎贝尔的单一神话）
救猫节拍表
角色弧模板
场景结构组件
按类型划分的节拍指南
子情节整合技术
类型特定的结构

使用 Grep 查找特定框架：

# 示例：查找三幕结构细节
grep -A 20 "Three-Act Structure" references/story_structures.md

第 3 步：确定结构需求

根据用户的请求和故事类型，推荐适当的框架：

惊悚/悬疑：具有强烈中点反转的三幕结构
奇幻/冒险：英雄之旅适用于任务叙事
青少年/当代：救猫用于紧凑的情感节拍
文学小说：专注于角色弧结构
浪漫：类型特定的结构，关系节拍

第 4 步：发展规划文件

创建或增强规划文件，包括：

故事概览

2-3 句话的前提
类型、目标受众、基调
中心主题和问题

情节结构

幕/章节分解，关键事件
引发事件和情节点
中点转折或启示
高潮和解决方案

角色弧

每个主要角色如何转变
弧线与情节节拍的整合

世界构建元素（如适用）

设置和地点
魔法系统或技术
社会结构或规则
历史背景

时间线

故事持续时间
关键事件序列
节奏考虑

第 5 步：创建规划文件

将规划文件写入 story-planning/[document-name].md。使用清晰的层次结构和 markdown 标题，便于导航。

章节与场景写作工作流程

第 1 步：收集故事上下文

在编写任何内容之前，全面阅读：

角色文件：所有相关的角色档案，以了解声音、动机、弧线 规划文件：故事结构、情节点、当前故事位置 前几章：最近的章节，以保持连续性（至少阅读前 1-2 章）摘要：整体故事前提和主题

这确保新内容与既定元素一致。

第 2 步：确定章节需求

确定：

故事位置：这在整个结构中适合哪里？
POV 角色：谁的视角？
场景目标：POV 角色在这场戏中想要什么？
冲突：什么阻碍了他们的目标？
结果：场景如何结束？（通常以复杂化结束）
角色发展：这里发生了什么弧线节拍？
情节推进：这里提出了什么故事问题或回答？

第 3 步：构建章节

应用场景结构组件：

场景（行动）

目标 - POV 角色追求的
冲突 - 遇到的反对
灾难 - 推动前进的负面结果

续集（反应）

反应 - 对灾难的情感反应
困境 - 处理选项
决定 - 导致下一个目标的选择

为节奏交替高张力（行动、冲突）和低张力（反思、世界构建）节拍。

第 4 步：以角色一致性写作

通过参考保持角色声音：

既定的个性特征
语言模式和词汇
行为模式（在压力下、快乐时、决策风格）
当前角色弧的位置
其他角色的关系

第 5 步：整合时间线标记

包括时间线参考以保持时间顺序清晰：

显式标记：“第 3 天”，“两周后”
隐式标记：一天中的时间，季节提示，事件参考
格式：章节标题或节间休息中的 **时间线：** 第 5 天，晚上

第 6 步：创建章节文件

将章节内容写入 chapters/chapter-[number].md 或 chapters/[chapter-name].md。包括：

章节标题

# 第 [Number] 章：[可选标题]

**时间线：** [何时发生]
**POV：** [角色名]
**地点：** [发生地点]

章节内容

逐场细分
对话和行动
角色思考（POV 角色）
描述性元素

第 7 步：记录连续性元素

写作后，记录任何新引入的信息：

角色启示或发展
情节点或线索
世界构建细节
时间线事件

这有助于在未来章节中保持一致性。

时间线跟踪

何时使用时间线跟踪

当：

用户请求时间线分析或事件排序
检查时间顺序一致性
跨章节规划事件顺序
识别未标记的时间段

运行时间线跟踪器

从项目根目录执行脚本：

python3 .claude/skills/storyboard-manager/scripts/timeline_tracker.py . --output markdown

输出格式选项：

markdown - 人类可读报告（默认）
json - 结构化数据以供进一步处理

理解时间线输出

脚本提供：

统计数据

跟踪的总事件数
出现的总角色数
每个角色的事件数

时间线视图

事件的顺序
章节/场景位置
每个事件中出现的角色
事件内容预览

警告

没有时间线标记的事件
提及但未在角色文件中定义的角色

根据时间线结果采取行动

运行跟踪器后：

审查警告 - 通过在章节中添加它们来解决缺少的时间线标记
检查顺序 - 验证事件是否按逻辑顺序发生
识别间隙 - 查找没有事件的时间段
角色跟踪 - 确保角色与他们的弧一致地出现

在缺少时间线标记的章节中添加时间线标记：

**时间线：** 第 7 天，早上

或使用内联标记：

自事件发生以来已经过去了三天...

一致性检查

何时使用一致性检查

当：

用户请求一致性分析
最终确定章节或幕之前
在进行重大角色或情节更改后
跟踪矛盾或错误时

运行一致性检查器

从项目根目录执行脚本：

python3 .claude/skills/storyboard-manager/scripts/consistency_checker.py . --output markdown

输出格式选项：

markdown - 带有问题细节的人类可读报告（默认）
json - 结构化数据以供程序分析

理解一致性输出

脚本在三个严重性级别中识别问题：

严重（🔴）

需要立即关注的严重矛盾
角色死后出现
基本情节矛盾

警告（⚠️）

潜在的不一致性待审查
年龄差异
物理描述矛盾
关系冲突

信息（ℹ️）

次要问题或变化
名字大小写不一致
风格变化

根据一致性结果采取行动

对于报告的每个问题：

阅读标记位置 - 查看提到的具体文件
确定真相 - 决定哪个版本是正确的（通常角色档案是权威性的）
更新文件 - 使用编辑工具修正矛盾
重新运行检查器 - 验证修复是否解决了问题

角色年龄不一致的示例工作流程：

问题：Maya 的年龄不一致
- 档案：18 岁
- 第 3 章：提到 "21 岁的 Maya"

修复：编辑 chapter-3.md 将 "21 岁" 改为 "18 岁"

一致性检查限制

自动检查器捕获：

物理属性矛盾
年龄差异
名字变化
基本世界构建事实

检查器不能捕获：

微妙的个性不一致
复杂的情节逻辑错误
主题矛盾
细腻的关系变化

手动审查对于深度一致性仍然至关重要。

最佳实践

渐进式上下文加载

不要一次加载所有参考文件。相反：

首先扫描项目结构
只阅读当前任务相关的相关角色文件
仅在需要特定指导时访问参考文档
使用 Grep 在大型参考文件中找到特定部分

保持类型声音

匹配故事的既定基调：

青少年：现在时态，即时情感联系，当代语言
奇幻：丰富的描述性语言，世界构建整合
惊悚：短句，高张力，感官细节
文学：复杂的散文，内部反思，象征元素

参考 summary.md 以确定目标受众并相应调整。

角色弧整合

每一章都应该服务于角色弧：

跟踪每个角色在他们的弧中的位置
显示渐进变化，而不是突然转变
使用情节事件来测试角色信仰
通过选择和行为展示成长

平衡展示与讲述

对于叙事写作：

展示通过行动、对话、身体反应展示情感
讲述压缩时间，有效提供必要信息
使用角色过滤描述（这个 POV 角色会注意到什么？）

处理多个 POV

当故事有多个视角时：

为每个 POV 角色创建独特声音
确保每个 POV 部分推进角色弧和情节
根据角色变化句子结构和词汇
跟踪每个角色知道与不知道的信息

常见用户请求和响应

“帮助我发展角色背景故事”

阅读现有角色文件以获取上下文
阅读角色档案（如果存在）以增强
访问 character_development.md 参考以获取背景故事框架
创建详细的背景故事，涵盖：幽灵/伤口，形成关系，关键历史
与他们的角色弧和故事角色整合

“写下一章”

阅读 summary.md 和故事规划文件
阅读章节中出现的所有角色的角色档案
阅读前两章以保持连续性
确定章节在故事结构中的位置
使用场景/续集结构编写章节
包括时间线标记和 POV/位置标题

“概述第二幕”

阅读摘要和任何现有规划文件
访问 story_structures.md 以获取结构指导
确定第二幕要求（复杂化，中点，紧张上升）
创建与角色弧对齐的节拍大纲
记录情节和角色弧如何相交

“检查我的故事一致性”

运行 consistency_checker.py 脚本
查看输出识别问题
阅读标记的文件以了解矛盾
为每个问题推荐具体修复
如果用户确认，提供编辑

“跟踪我的故事时间线”

运行 timeline_tracker.py 脚本
查看显示事件顺序的输出
识别时间顺序中的间隙或不一致性
推荐在缺少的地方添加时间线标记
提供按角色或章节组织的时间线摘要

“我的惊悚片应该使用什么结构？”

访问 story_structures.md 参考
推荐三幕结构或救猫
解释惊悚片特定要求（升级紧张，倒计时）
提供适应他们故事概念的节拍表
提供创建详细规划文件

资源

scripts/timeline_tracker.py

分析 markdown 文件以提取和组织时间线事件的 Python 脚本。跟踪角色出现，识别时间标记，按时间顺序分组事件，并标记一致性问题。

用法： 从项目根目录运行 python3 .claude/skills/storyboard-manager/scripts/timeline_tracker.py .

scripts/consistency_checker.py

检测故事文件中角色细节、物理描述、年龄、名字和世界构建事实不一致性的 Python 脚本。输出严重性排名的问题及文件位置。

用法： 从项目根目录运行 python3 .claude/skills/storyboard-manager/scripts/consistency_checker.py .

references/character_development.md

创建多维角色的综合框架，包括核心元素、背景故事结构、弧线类型、关系动态、声音发展和一致性指南。

何时加载： 开发新角色，增强现有档案，解决角色一致性问题，或规划角色弧。

references/story_structures.md

详细参考涵盖主要故事结构（三幕结构、英雄之旅、救猫），角色弧模板，场景结构，节拍指南，情节发展技术，和类型特定的结构。

何时加载： 规划故事大纲，组织幕，组织情节节拍，确定节奏，或应用特定叙事框架。