storyboard-manager

分镜管理器

概览

分镜管理器技能为 Claude 提供创意写作工作流所需的专业知识和工具。它提供人物塑造框架、故事结构模式、自动时间线追踪，以及叙事项目中的一致性检查。此技能会自动适应各种分镜文件夹结构，同时遵循小说、剧本和连载小说写作的最佳实践。

核心能力

此技能提供四项主要能力：

1. 人物塑造与管理

支持创建深入且一致的人物档案，包括背景故事、人物弧光和人际关系。

2. 故事规划与结构

使用成熟的框架（三幕式、英雄之旅、《救猫咪》等）指导情节发展，并帮助组织叙事元素。

3. 章节与场景写作

生成章节内容、场景拆解和对话，并确保与已设定的人物和情节保持一致。

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

使用自动化工具核验时间顺序一致性、人物连贯性和世界观构建的自洽性。

检测项目结构

分镜管理器会自动检测并适配各种文件夹组织方式。请留意以下常见目录模式：

人物文件夹： 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。

工作流决策树

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

User Request
├─ Character-related? ("develop character," "create backstory," "character arc")
│  └─ → Character Development Workflow
│
├─ Planning/Plot? ("outline story," "plan act 2," "plot structure")
│  └─ → Story Planning Workflow
│
├─ Writing content? ("write chapter," "generate scene," "continue story")
│  └─ → Chapter/Scene Writing Workflow
│
└─ Checking/Analysis? ("check consistency," "track timeline," "find contradictions")
   ├─ Timeline? → Use timeline_tracker.py script
   └─ Consistency? → Use consistency_checker.py script

人物塑造工作流

步骤 1：收集上下文

塑造人物前，请阅读现有的人物文件，以了解：

• 已采用的命名规范和档案格式
• 现有人物及其关系
• 故事类型和基调
• 已使用的人物原型

使用 Read 工具检查 characters 目录中的现有人物文件。

步骤 2：查阅人物塑造框架

需要详细的人物塑造指导时，请阅读 references/character_development.md，其中包含：

• 核心人物要素（性格、动机、目标）
• 背景故事框架（创伤／伤口、塑造性关系）
• 人物弧光类型（积极转变、平稳、消极）
• 关系动态
• 塑造人物声音的技巧
• 一致性准则

若要高效查找特定指导，请使用 Grep 搜索相关章节：

# Example: Find guidance on character arcs
grep -i "character arc" references/character_development.md

步骤 3：塑造人物档案

创建或完善人物档案，包含以下必要要素：

基本信息

• 姓名、年龄、角色、外貌
• 关键性格特质（包括优点和缺点）

背景

• 出身和塑造性经历
• 影响其行为的创伤／伤口
• 重要关系和家庭动态

人物弧光

• 初始信念或缺陷
• 想要的与需要的（外在目标与内在成长）
• 转变历程
• 最终状态

人际关系

• 与其他人物的联系
• 关系类型（盟友、对手、导师等）
• 关系如何演变

独特要素

• 能力、技能或特殊知识
• 秘密或隐藏的一面
• 说话／语言模式
• 人物特有的癖好

步骤 4：确保一致性

交叉核对：

• 现有人物档案（避免角色／特质重复）
• 故事规划文档（确保符合情节需求）
• 摘要／概览（与故事类型和基调相符）

步骤 5：创建或更新文件

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

故事规划工作流

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

阅读现有规划文档，了解：

• 故事概念和前提
• 已确定的情节点或大纲
• 目标受众和类型
• 主题和核心问题
• 规划的结构（如有）

查看 story-planning/、outline/ 等文件夹，或 summary.md 等文件。

步骤 2：查阅故事结构参考资料

如需详细的结构指导，请阅读 references/story_structures.md，其中包括：

• 三幕结构
• 英雄之旅（坎贝尔的单一神话）
• 《救猫咪》节拍表
• 角色弧光模板
• 场景结构要素
• 按类型划分的节奏指南
• 支线整合技巧
• 特定类型的结构

使用 Grep 查找特定框架：

# Example: Find Three-Act Structure details
grep -A 20 "Three-Act Structure" references/story_structures.md

步骤 3：确定结构需求

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

• 惊悚／悬疑：采用具有强有力中点逆转的三幕结构
• 奇幻／冒险：采用适用于任务叙事的英雄之旅
• YA／当代题材：采用《救猫咪》，打造紧凑的情感节拍
• 文学小说：侧重角色弧光结构
• 爱情：采用包含关系发展节拍的特定类型结构

步骤 4：编写规划文档

创建或完善规划文档，包含：

故事概述

• 用 2-3 句话概述故事前提
• 类型、目标受众、基调
• 核心主题和问题

情节结构

• 按幕／章节梳理关键事件
• 诱发事件和情节点
• 中点转折或揭示
• 高潮和结局

角色弧光

• 每位主角如何转变
• 角色弧光如何与情节点结合

世界构建要素（如适用）

• 背景和地点
• 魔法体系或科技
• 社会结构或规则
• 历史背景

时间线

• 故事持续时间
• 关键事件顺序
• 节奏方面的考量

步骤 5：创建规划文件

将规划文档写入 story-planning/[document-name].md。使用清晰的层级结构和 Markdown 标题，以便于浏览。

章节与场景写作工作流

步骤 1：收集故事背景

开始写作前，请全面阅读：

角色文件：所有相关角色档案，以了解角色的语气、动机和弧光
规划文档：故事结构、情节点和当前故事进展
前序章节：近期章节，以保持连贯性（至少阅读前 1-2 章）
摘要：整体故事前提和主题

这能确保新内容与已确立的要素保持一致。

步骤 2：明确章节要求

确定：

• 故事位置：这一部分在整体结构中处于什么位置？
• POV 角色：以谁的视角展开？
• 场景目标：POV 角色在这一场景中想要什么？
• 冲突：什么因素阻碍了他们实现目标？
• 结果：场景如何结束？（通常以新的阻碍收尾）
• 角色发展：这里会出现哪些弧光节拍？
• 情节推进：这里会提出或解答哪些故事问题？

步骤 3：构建章节结构

运用场景结构要素：

场景（行动）

1. 目标 —— POV 角色追求什么
2. 冲突 —— 遇到的阻碍
3. 灾难 —— 推动故事继续发展的负面结果

后续（反应）

1. 反应 —— 对灾难的情绪回应
2. 两难 —— 权衡各种选择
3. 决定 —— 引出下一个目标的选择

在高张力（行动、冲突）和低张力（反思、世界构建）节拍之间交替，以把握节奏。

步骤 4：保持角色一致性

参考以下内容，保持角色的语气一致：

• 已确立的性格特征
• 说话方式和词汇
• 行为模式（在压力下、开心时，以及做决定时）
• 当前所处的角色弧光阶段
• 与同场其他角色的关系

步骤 5：整合时间线标记

添加时间线引用，确保时间顺序清晰：

• 明确标记：“第 3 天”“两周后”
• 隐含标记：一天中的时段、季节线索、事件引用
• 格式：在章节标题或分节处使用 **Timeline:** Day 5, Evening

步骤 6：创建章节文件

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

章节标题

# Chapter [Number]: [Optional Title]

**Timeline:** [When this occurs]
**POV:** [Character name]
**Location:** [Where this takes place]

章节内容

• 按场景逐一拆分
• 对话和动作
• 角色想法（POV 角色）
• 描述性元素

步骤 7：记录连续性要素

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

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

这有助于后续章节保持一致性。

时间线跟踪

何时使用时间线跟踪

在以下情况下调用时间线跟踪器：

• 用户要求分析时间线或排列事件顺序
• 检查时间顺序的一致性
• 规划跨章节的事件顺序
• 找出未标记的时间段

运行时间线跟踪器

在项目根目录执行脚本：

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

输出格式选项：

• markdown - 易于阅读的报告（默认）
• json - 供后续处理的结构化数据

理解时间线输出

脚本会提供：

统计信息

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

时间线视图

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

警告

• 未带时间线标记的事件
• 已提及但未在角色文件中定义的角色

根据时间线结果采取行动

运行跟踪器后：

1. 查看警告 - 在章节中添加缺失的时间线标记
2. 检查顺序 - 确认事件顺序合乎逻辑
3. 找出间隔 - 查找没有事件的时间段
4. 跟踪角色 - 确保角色的出场与其人物弧线保持一致

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

**Timeline:** Day 7, Morning

或使用内联标记：

Three days had passed since the incident...

一致性检查

何时使用一致性检查

在以下情况下调用一致性检查器：

• 用户要求进行一致性分析
• 完成章节或幕之前
• 对角色或情节进行重大修改之后
• 跟踪矛盾或错误时

运行一致性检查器

在项目根目录执行脚本：

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

输出格式选项：

• markdown - 包含问题详情的易读报告（默认）
• json - 供程序分析的结构化数据

理解一致性输出

脚本会按三个严重程度等级识别问题：

严重（🔴）

• 需要立即处理的重大矛盾
• 角色在死亡后再次出现
• 根本性的情节矛盾

警告（⚠️）

• 需要检查的潜在不一致
• 年龄差异
• 外貌描述矛盾
• 关系冲突

信息（ℹ️）

• 轻微问题或差异
• 姓名大小写不一致
• 风格差异

根据一致性检查结果采取行动

对于报告的每个问题：

1. 阅读标记位置 - 查看提及的具体文件
2. 确定正确信息 - 决定哪个版本正确（通常以角色档案为准）
3. 更新文件 - 使用 Edit 工具修复矛盾
4. 重新运行检查器 - 确认修复已解决问题

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

Issue: Age inconsistency for Maya
- Profile: 18 years old
- Chapter 3: mentions "21-year-old Maya"

Fix: Edit chapter-3.md to change "21-year-old" to "18-year-old"

一致性检查的局限性

自动检查器可以发现：

• 外貌属性矛盾
• 年龄差异
• 姓名变体
• 基本的世界构建事实

检查器无法发现：

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

深入检查一致性仍需人工审阅。

最佳实践

渐进式加载上下文

不要一次性加载所有参考文件，而应：

1. 先扫描项目结构
2. 仅阅读与当前任务相关的角色文件
3. 仅在需要具体指导时查阅参考文档
4. 使用 Grep 在大型参考文件中查找特定章节

保持体裁语气

贴合故事已确立的语气：

• YA：使用现在时，建立直接的情感联结，采用当代语言
• 奇幻：运用丰富的描写语言，将世界观融入故事
• 惊悚：使用短句，营造高度紧张感，加入感官细节
• 文学：使用复杂的散文，融入内心反思和象征元素

参考 summary.md，确定目标读者并据此调整。

融入角色弧光

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

• 追踪每个角色在弧光中的位置
• 展现渐进式改变，而非突然转变
• 通过情节事件检验角色的信念
• 通过选择和行为展现成长

平衡展现与讲述

对于叙事写作：

• 通过动作、对话和生理反应展现情绪
• 讲述用于压缩时间，高效提供必要信息
• 使用受角色视角筛选的描写（当前视角角色会注意到什么？）

处理多视角

当故事采用多个视角时：

• 为每个视角角色塑造独特的声音
• 确保每个视角段落都能推进该角色的弧光和情节
• 根据角色调整句式结构和词汇
• 追踪每个角色知道和不知道的事情

常见用户请求与响应

“帮我完善一个角色的背景故事”

1. 阅读现有角色文件，了解背景
2. 阅读角色档案（如果有），以进一步完善
3. 查阅 character_development.md 参考文件，获取背景故事框架
4. 创建详细的背景故事，涵盖：心结/创伤、重要的人际关系、关键经历
5. 将其融入角色弧光和故事中的角色定位

“写下一章”

1. 阅读 summary.md 和故事规划文档
2. 阅读本章出场角色的所有档案
3. 阅读前两章，确保情节连贯
4. 确定本章在故事结构中的位置
5. 按照场景/后续结构撰写章节
6. 添加时间线标记和视角/地点标题

“列出第二幕大纲”

1. 阅读摘要和任何现有的规划文档
2. 查阅 story_structures.md，获取结构指导
3. 确定第二幕的要求（复杂化、中点、紧张感升级）
4. 创建与角色弧光相契合的逐拍大纲
5. 标明情节与角色弧光的交汇方式

“检查我的故事是否前后一致”

1. 运行 consistency_checker.py 脚本
2. 检查输出，了解发现的问题
3. 阅读标记出的文件，理解矛盾之处
4. 针对每个问题提出具体的修正建议
5. 如果用户确认，提出代为修改

“追踪故事的时间线”

1. 运行 timeline_tracker.py 脚本
2. 检查显示事件顺序的输出
3. 找出时间顺序上的缺漏或不一致之处
4. 建议在缺少时间线标记的位置补充标记
5. 按角色或章节整理并提供时间线摘要

“我的惊悚小说应该采用什么结构？”

1. 查阅 story_structures.md 参考文件
2. 推荐三幕结构或 Save the Cat
3. 说明惊悚小说的特定要求（紧张感逐步升级、倒计时）
4. 根据故事构想提供调整后的节拍表
5. 提出可创建详细的规划文档

资源

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

详细介绍主要故事结构（三幕式、英雄之旅、《救猫咪》）、角色弧模板、场景结构、节奏指南、情节发展技巧和特定类型的结构。

在以下情况下加载： 规划故事大纲、构建幕结构、组织情节点、确定节奏，或应用特定的叙事框架。