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。包括:
章节标题
# 第[数字]章:[可选标题]
**时间线:**[何时发生]
**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- 结构化数据,用于程序分析
理解一致性输出
脚本在三个严重性级别中识别问题:
严重(🔴)
- 需要立即关注的严重矛盾
- 角色死后出现
- 基本情节矛盾
警告(⚠️)
- 潜在的不一致性待审查
- 年龄差异
- 物理描述矛盾
- 关系冲突
信息(ℹ️)
- 小问题或变化
- 名字大小写不一致
- 风格变化
根据一致性结果采取行动
对于报告的每个问题:
- 阅读标记位置 - 查看提到的具体文件
- 确定真相 - 决定哪个版本是正确的(通常角色档案是权威性的)
- 更新文件 - 使用Edit工具修正矛盾
- 重新运行检查器 - 验证修复是否解决了问题
角色年龄不一致的示例工作流程:
问题: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
详细参考涵盖主要故事结构(三幕结构、英雄之旅、救猫法则),角色弧模板,场景结构,步调指南,情节发展技术,和类型特定的结构。
何时加载: 规划故事大纲,组织幕,组织情节节拍,确定步调,或应用特定叙事框架。