关于 fiction-workshop
fiction-workshop 为长篇小说提供分阶段的协作写作与编辑流程,面向需要维护多章节连贯性的作者。它通过故事圣经、编辑角色和无背景读者测试管理创作进度与一致性。
主要功能
- 01建立并持续更新故事圣经
- 02按章节进行构思、起草与修改
- 03按编辑视角开展专项审阅
- 04用新读者测试理解度与吸引力
- 05记录会话进度和未决问题
适用场景
- 01规划长篇小说的角色、情节与世界
- 02对章节进行结构或文字编辑
- 03检查跨章节的时间线和设定一致性
- 04发现缺少作者背景时读者难以理解之处
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rhavekost/ author-toolkit --skill fiction-workshop安装后在 Claude Code 中输入/fiction-workshop确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/scene-worksheet.mdstory-bible-template.mdreferences/brainstorming.mdcharacter-work.mdcontinuity-tracking.mddevelopmental-editing.mdline-editing.mdscifi-worldbuilding.mdthriller-craft.md详细介绍
小说创作工作坊
分三个阶段开展协作小说创作的编辑工作流:构建故事圣经、章节开发和读者测试。
会话连续性
小说项目可能持续数周或数月。Claude 无法记住不同会话之间的内容,因此故事圣经就是你的持久状态。
- 会话开始时: 在开展任何其他工作之前,先阅读
story-bible.md(或项目中对此文件的命名)。浏览sessions/中近期的文件,查找尚未解决的线索。 - 会话结束时: 在
sessions/YYYY-MM-DD_topic-slug.md写一则简短记录,总结已完成的工作、作出的决定以及停止的位置。两到五句话即可。 - 基础设定发生变化时: 如果前提、角色简介、世界规则或重大情节转折发生变化,立即更新故事圣经。故事圣经是权威依据,而不是一次性模板。
- 指出尚未解决的问题: 开始新工作时,列出此前会话留下的问题,并询问用户希望先处理哪些问题,再继续。
适用场景
此技能适用于:
- ✅ 长篇小说(长篇小说、中篇小说、短篇小说集)
- ✅ 需要保持角色和情节一致性的多章节手稿
- ✅ 需要进行开发性编辑或文字编辑的小说项目
- ✅ 世界构建复杂或包含多个 POV 角色的故事
不适用场景
此技能不适用于:
- ❌ 闪小说或单个场景(少于 2000 字)——工作流过于繁重
- ❌ 诗歌或实验性散文——需要采用不同的编辑方法
- ❌ 电影剧本或舞台剧——格式惯例不同
- ❌ 技术写作、文档或学术论文
- ❌ 商务写作或营销文案
对于叙事类非虚构作品(回忆录、带有故事元素的自助书籍),请改用 narrative-nonfiction 技能。
编辑角色
角色主要用于阶段 2(章节开发)和阶段 3(读者测试);阶段 1 是自由形式的故事圣经构建,无需调用特定角色。通过指定视角来切换这些角色:
| 角色 | 调用方式 | 关注重点 |
|---|---|---|
| 开发性编辑 | “以开发性编辑的身份……” | 情节、节奏、结构、利害关系、主题 |
| 文字编辑 | “以文字编辑的身份……” | 散文节奏、措辞、“展示而非讲述” |
| 角色顾问 | “以角色顾问的身份……” | 语气一致性、动机、人物弧光、关系 |
| 连续性追踪员 | “以连续性追踪员的身份……” | 时间线、世界设定事实、内部一致性 |
| 头脑风暴搭档 | “头脑风暴模式……” | “如果……”的探索、解决问题、打破僵局 |
只加载与当前调用角色相匹配的参考文件。不要在会话开始时预先加载所有参考文件——这会浪费上下文预算。如果在会话中途切换角色,请加载新的参考文件;除非工作明确需要兼顾两种角色,否则将此前的参考文件视为当前任务范围之外。
各角色的详细指南见 references/。
阶段 1:构建故事圣经
目标: 在起草或编辑之前,建立共同的故事基础。
初始问题
- 类型和目标读者是谁?
- 核心前提/故事梗概是什么?
- 主角是谁?他们想要什么?
- 核心冲突是什么?
- 希望读者经历怎样的情感旅程?
- 已写好的内容与计划中的内容分别有多少?
故事圣经组件
情节: 故事前提、三幕结构/节拍表、重大转折、结局(即使只是粗略构想)
角色: 主角(欲望/需求/创伤/成长弧)、反派(动机/威胁)、配角(作用/关系)、POV 声线备注
世界: 背景设定(时间/地点/规则)、科技/魔法体系、社会结构、感官基调
主题: 核心问题、道德主张、反复出现的意象
如果已有故事圣经文档,请先审阅。如果没有,可使用 assets/story-bible-template.md 创建一份。
故事圣经条目示例(角色):
ALEX CHEN - Protagonist
Want: Expose the conspiracy and clear her name
Need: Learn to trust her instincts over institutional authority
Wound: Mentor betrayed her at previous agency, causing career setback
Arc: Lone wolf → realizes she needs allies → builds trust with team
Voice notes: Analytical, dry humor when stressed, avoids emotional language
Key relationship: Tension with Handler (wants to trust, can't fully)
退出条件: 对故事基础要素有充分把握。无需询问基础问题,就能讨论角色动机、预测情节影响并识别主题线索。
阶段 2:章节开发
目标: 通过头脑风暴 → 筛选 → 起草 → 润色的循环,起草或完善章节。
开始创作? → 创作工作流 | 编辑现有内容? → 编辑工作流
创作工作流
-
场景规划
- 必须发生什么(情节)?采用谁的 POV?
- 本章的情感弧线是什么?
- 读者在结尾会了解到什么/产生什么感受?
-
头脑风暴列出节拍(5-15 个选项):开场钩子、关键时刻、对话、感官细节、结尾
示例(惊悚场景): 同一辆车连续三天停在咖啡店外 | 凌晨 3 点手机响起,来电号码被屏蔽 | 门底下塞进一张监控照片 | 同事提到只有监控才会知道的细节 | 窗户上映出摄像头镜头的反光 | 秘密投递点被清空 | 安全屋钥匙打不开门 | 联系人错过第一次报平安
然后筛选:“哪些能立即营造紧张感?有没有可以合并的?”
-
筛选: 询问对方要保留、合并还是舍弃哪些内容。了解原因有助于调整方向。
-
起草: 撰写章节。使用
str_replace进行修订,绝不重新输出全文。 -
润色: 根据反馈反复修改。经过 3 轮修改且变动很少后,询问:“哪些内容可以删掉?”
编辑工作流
-
阅读并诊断: 本章试图达成什么、哪些地方效果良好、哪些地方失去张力/清晰度
-
启用相应角色: 结构/节奏 → 发展编辑 | 文笔 → 文字编辑 | 声音 → 角色 | 事实 → 连贯性
-
提出修改建议: 给出具体、精确的编辑建议,并简要说明“原因”
-
实施: 使用
str_replace。修改后提供文件链接。 -
迭代: 直至章节达成目的
特定角色指导
启用特定编辑角色时,加载对应的参考文件:
- 发展编辑 →
references/developmental-editing.md - 文字编辑 →
references/line-editing.md - 角色创作 →
references/character-work.md - 连贯性 →
references/continuity-tracking.md - 头脑风暴 →
references/brainstorming.md - 惊悚题材创作技巧 →
references/thriller-craft.md - 科幻世界构建 →
references/scifi-worldbuilding.md
阶段 3:读者测试
目标: 验证读者在不了解作者背景信息的情况下,也能读懂手稿。
使用全新的子 Agent(不提供故事圣经):
- 理解: 能否概述情节、理解动机、识别利害关系?
- 投入度: 在哪里失去兴趣、产生疑问或感到困惑?
- 情感体验: 关键时刻是否打动读者?结局是否令人满意?主题是否清晰?
常见问题: 动机不清 | 节奏拖沓 | 情节转折缺乏铺垫 | 令人困惑
如果读者理解困难: 找出缺口 → 返回阶段 2 → 重新测试
退出条件: 读者无需作者解释,就能理解故事并投入其中。
自查:是否正常运行?
使用以下检查点,确认你是否在正确地遵循工作流程。
构建 Story Bible 后:
- 不重读笔记,你能描述主角的欲望与需求之间的区别吗?
- 你能预测反派在遇到新情境时会如何反应吗?
- 你理解这本书探讨的主题问题吗?
- 你能用 2-3 句话概述三幕结构吗?
调用某个角色设定后:
- 你是否在请求中明确说了“As [persona name]...”?
- 反馈是否聚焦于该角色设定的领域(结构编辑 = 结构,文字编辑 = 文笔)?
- 你是否避免在一轮反馈中混合多个角色设定的意见?
修改后:
- 你是否使用
str_replace进行精准修改,而不是重新输出整个章节? - 你能否说清楚改了什么,以及为什么这样更好?
- 修改是否符合 Story Bible(人物声音、情节逻辑、世界规则)?
头脑风暴后:
- 你是否先生成了 5 个以上的选项,再从中挑选?
- 你是否通过协作筛选选项,而不是直接采用第一个建议?
- 你能否解释为什么选中的选项比其他方案更有力?
宣称“完成”之前:
- 是否有一位不了解 Story Bible 内容的新子 Agent 阅读了手稿?
- 这位新读者是否理解情节、人物动机和利害关系?
- 是否发现并解决了任何缺漏或令人困惑之处?
如果任何检查点的答案是“否”,请先返回相应阶段,再继续。
停止点
每个角色设定和阶段都有明确的终点。到达后就停止。不要自动推进到下一个角色设定,不要悄悄扩大范围,也不要在对方要求诊断时开始起草。
| 工具 / 阶段 | 停止条件…… | 然后 |
|---|---|---|
| Story Bible 构建(阶段 1) | Story Bible 自查通过 | 交还给作者。不要自动进入起草阶段。 |
| 结构编辑 | 完成请求范围内的一轮完整结构审查,并提交问题清单 | 等待作者应用修改。除非对方明确要求,否则不要继续改写。 |
| 文字编辑 | 完成一章(或指定范围)的文字编辑;经过 3 轮且修改很少后,只问一次“可以删掉什么?” | 如果没有进一步指示,就停止。文字编辑有其自然上限。 |
| 人物顾问 | 完成对指定人物 / 场景的一次咨询 | 不要习惯性地检查其他人物或场景。等待下一次调用。 |
| 连续性追踪器 | 审查生成标记清单 | 停止。不要自动修复。由作者判断哪些标记属实,以及如何处理。 |
| 头脑风暴伙伴 | 筛选环节选定了一个方向(或审阅并否决了 5 个以上的选项) | 交还给作者。除非对方明确要求,否则不要将其扩写成章节。 |
| 读者测试(阶段 3) | 提交新子 Agent 的报告 | 停止。由作者决定是否返回阶段 2,以及根据哪些发现返回。 |
| 会话 | 到达停止点,或上下文窗口即将填满 | 如果基础设定有所变化,更新 Story Bible;撰写一份 sessions/ 记录;然后停止。 |
如果作者明确要求你越过停止点继续,就可以继续,但要说明接下来要做什么(“我现在将从连续性审查转为应用修复”),让范围变化清晰可见。
常见错误
| 错误 | 发生原因 | 修正方法 |
|---|---|---|
| 跳过故事圣经 | “我对自己的故事已经足够了解了” | 故事圣经不是给你看的,而是给 Claude 看的。没有共享的背景信息,反馈就会漏掉关键故事要素。把它建起来。 |
| 没有指定角色,反馈流于笼统 | 操之过急,忘了调用特定角色 | 在提示词中明确说“作为发展编辑……”或“作为文字编辑……”。不同视角能发现不同问题。 |
| 重新输出整章内容 | 沿用其他编辑场景中的习惯 | 仅使用 str_replace 做精细修改。重新输出会消耗上下文,也让修改难以追踪。修改后链接到文件。 |
| 结构尚未理顺就开始逐行修改 | 想要立即“修正”文笔 | 如果存在情节、节奏或人物问题,逐行修改就是白费力气。始终先做发展编辑。参见下方示例。 |
| 跳过读者测试 | “我已经读过太多遍了” | 你掌握作者视角的背景信息。读者测试会使用不了解故事圣经的全新子 Agent,发现读者可能遇到的理解障碍。 |
| 一次启用太多角色 | 想在一轮中解决所有问题 | 每轮只启用一个角色。发展编辑 → 人物 → 文字 → 连贯性。聚焦的反馈才有可操作性。 |
| 头脑风暴后不筛选 | 选了第一个听起来不错的点子 | 先生成 5-15 个选项,再进行筛选。第一个点子很少是最好的。数量才能带来质量。 |
示例:发展编辑与文字编辑的区别
同一段文字,不同视角:
Sarah 走进办公室。她的老板看起来很生气。“我们得谈谈,”他说。她紧张地坐下。
文字编辑的反馈(文笔层面):
- “走进”这个动词力度不足——试试“阔步走进”或“悄悄溜进”
- “看起来很生气”是在直接告知,而非呈现——描写紧皱的眉头、紧绷的下颌
- “紧张地”是依赖副词的写法——通过动作表现紧张
发展编辑的反馈(结构与利害关系):
- Sarah 在这一场景中想要什么?她的老板想要什么?
- 如果这是冲突场景,就需要铺垫——冲突的来龙去脉是什么?
- 利害关系似乎不够重大——这场谈话为何对故事很重要?
- 节奏:这一章安排这场冲突合适吗?还是应该让紧张感再积累一段时间?
**区别:**文字编辑润色句子。发展编辑确保场景在故事中有存在的价值。始终先做发展编辑。
命令速查
| 需求 | 命令 |
|---|---|
| 开始新项目 | “我们来为 [project] 创建故事圣经” |
| 发展编辑 | “作为发展编辑,分析 [chapter/section]” |
| 文字编辑 | “作为文字编辑,润色 [scene/passage]” |
| 检查人物 | “作为人物顾问,[character] 的 [action] 符合人物设定吗?” |
| 连贯性审查 | “作为连贯性追踪员,检查 [chapters X-Y] 是否存在前后矛盾” |
| 突破创作瓶颈 | “头脑风暴模式——我需要 [solve problem]” |
| 测试可读性 | “对 [chapter/section] 进行全新阅读” |
发现项格式
当此技能的诊断模式(发展编辑评析、连贯性追踪标记)
生成发现项时,请按照
../../references/finding-schema.json 的规范输出:audit(使用模式
名称,例如 "developmental-editing")、technique(命名的写作
技巧,例如 "Want/Need/Wound/Lie alignment")、severity
(note/suggestion/warning)、location(文件/行号/引文)、issue、
confidence("judgment"——此技能不包含确定性组件),并可选填
exemplar(一句话的示例,直接写在此处;此技能目前尚无整理好的示例库——
可在适当时逐步扩充)。头脑风暴和草稿提案的输出不属于此
规范的范围。
文件
references/developmental-editing.md- 情节、结构、节奏分析(另请参阅story-structure技能,了解关键节拍百分比和路标诊断)references/line-editing.md- 润色文本references/character-work.md- 角色声音、动机和弧线跟踪(另请参阅character-archetypes技能,了解角色定位/性格原型分析)references/continuity-tracking.md- 时间线和事实一致性references/brainstorming.md- 创意生成技巧references/thriller-craft.md- 悬疑题材专属指导references/scifi-worldbuilding.md- 技术准确性、推测规则assets/story-bible-template.md- 空白故事圣经结构assets/scene-worksheet.md- 场景级分析模板