mcpField
F
fiction-workshop

fiction-workshop

github.com/rhavekost创意与媒体202.1k 次安装今天更新
代码仓库

关于 fiction-workshop

fiction-workshop 为长篇小说提供分阶段的协作写作与编辑流程,面向需要维护多章节连贯性的作者。它通过故事圣经、编辑角色和无背景读者测试管理创作进度与一致性。

主要功能

  1. 01建立并持续更新故事圣经
  2. 02按章节进行构思、起草与修改
  3. 03按编辑视角开展专项审阅
  4. 04用新读者测试理解度与吸引力
  5. 05记录会话进度和未决问题

适用场景

  1. 01规划长篇小说的角色、情节与世界
  2. 02对章节进行结构或文字编辑
  3. 03检查跨章节的时间线和设定一致性
  4. 04发现缺少作者背景时读者难以理解之处

安装

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

$npx skills add https://github.com/rhavekost/author-toolkit --skill fiction-workshop

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/
scene-worksheet.md
story-bible-template.md
references/
brainstorming.md
character-work.md
continuity-tracking.md
developmental-editing.md
line-editing.md
scifi-worldbuilding.md
thriller-craft.md

详细介绍

小说创作工作坊

分三个阶段开展协作小说创作的编辑工作流:构建故事圣经、章节开发和读者测试。

会话连续性

小说项目可能持续数周或数月。Claude 无法记住不同会话之间的内容,因此故事圣经就是你的持久状态。

  • 会话开始时: 在开展任何其他工作之前,先阅读 story-bible.md(或项目中对此文件的命名)。浏览 sessions/ 中近期的文件,查找尚未解决的线索。
  • 会话结束时: 在 sessions/YYYY-MM-DD_topic-slug.md 写一则简短记录,总结已完成的工作、作出的决定以及停止的位置。两到五句话即可。
  • 基础设定发生变化时: 如果前提、角色简介、世界规则或重大情节转折发生变化,立即更新故事圣经。故事圣经是权威依据,而不是一次性模板。
  • 指出尚未解决的问题: 开始新工作时,列出此前会话留下的问题,并询问用户希望先处理哪些问题,再继续。

适用场景

此技能适用于:

  • ✅ 长篇小说(长篇小说、中篇小说、短篇小说集)
  • ✅ 需要保持角色和情节一致性的多章节手稿
  • ✅ 需要进行开发性编辑或文字编辑的小说项目
  • ✅ 世界构建复杂或包含多个 POV 角色的故事

不适用场景

此技能不适用于:

  • ❌ 闪小说或单个场景(少于 2000 字)——工作流过于繁重
  • ❌ 诗歌或实验性散文——需要采用不同的编辑方法
  • ❌ 电影剧本或舞台剧——格式惯例不同
  • ❌ 技术写作、文档或学术论文
  • ❌ 商务写作或营销文案

对于叙事类非虚构作品(回忆录、带有故事元素的自助书籍),请改用 narrative-nonfiction 技能。

编辑角色

角色主要用于阶段 2(章节开发)和阶段 3(读者测试);阶段 1 是自由形式的故事圣经构建,无需调用特定角色。通过指定视角来切换这些角色:

角色调用方式关注重点
开发性编辑“以开发性编辑的身份……”情节、节奏、结构、利害关系、主题
文字编辑“以文字编辑的身份……”散文节奏、措辞、“展示而非讲述”
角色顾问“以角色顾问的身份……”语气一致性、动机、人物弧光、关系
连续性追踪员“以连续性追踪员的身份……”时间线、世界设定事实、内部一致性
头脑风暴搭档“头脑风暴模式……”“如果……”的探索、解决问题、打破僵局

只加载与当前调用角色相匹配的参考文件。不要在会话开始时预先加载所有参考文件——这会浪费上下文预算。如果在会话中途切换角色,请加载新的参考文件;除非工作明确需要兼顾两种角色,否则将此前的参考文件视为当前任务范围之外。

各角色的详细指南见 references/。


阶段 1:构建故事圣经

目标: 在起草或编辑之前,建立共同的故事基础。

初始问题
  1. 类型和目标读者是谁?
  2. 核心前提/故事梗概是什么?
  3. 主角是谁?他们想要什么?
  4. 核心冲突是什么?
  5. 希望读者经历怎样的情感旅程?
  6. 已写好的内容与计划中的内容分别有多少?
故事圣经组件

情节: 故事前提、三幕结构/节拍表、重大转折、结局(即使只是粗略构想)

角色: 主角(欲望/需求/创伤/成长弧)、反派(动机/威胁)、配角(作用/关系)、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:章节开发

目标: 通过头脑风暴 → 筛选 → 起草 → 润色的循环,起草或完善章节。

开始创作? → 创作工作流 | 编辑现有内容? → 编辑工作流

创作工作流
  1. 场景规划

    • 必须发生什么(情节)?采用谁的 POV?
    • 本章的情感弧线是什么?
    • 读者在结尾会了解到什么/产生什么感受?
  2. 头脑风暴列出节拍(5-15 个选项):开场钩子、关键时刻、对话、感官细节、结尾

    示例(惊悚场景): 同一辆车连续三天停在咖啡店外 | 凌晨 3 点手机响起,来电号码被屏蔽 | 门底下塞进一张监控照片 | 同事提到只有监控才会知道的细节 | 窗户上映出摄像头镜头的反光 | 秘密投递点被清空 | 安全屋钥匙打不开门 | 联系人错过第一次报平安

    然后筛选:“哪些能立即营造紧张感?有没有可以合并的?”

  3. 筛选: 询问对方要保留、合并还是舍弃哪些内容。了解原因有助于调整方向。

  4. 起草: 撰写章节。使用 str_replace 进行修订,绝不重新输出全文。

  5. 润色: 根据反馈反复修改。经过 3 轮修改且变动很少后,询问:“哪些内容可以删掉?”

编辑工作流
  1. 阅读并诊断: 本章试图达成什么、哪些地方效果良好、哪些地方失去张力/清晰度

  2. 启用相应角色: 结构/节奏 → 发展编辑 | 文笔 → 文字编辑 | 声音 → 角色 | 事实 → 连贯性

  3. 提出修改建议: 给出具体、精确的编辑建议,并简要说明“原因”

  4. 实施: 使用 str_replace。修改后提供文件链接。

  5. 迭代: 直至章节达成目的

特定角色指导

启用特定编辑角色时,加载对应的参考文件:

  • 发展编辑 → 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(不提供故事圣经):

  1. 理解: 能否概述情节、理解动机、识别利害关系?
  2. 投入度: 在哪里失去兴趣、产生疑问或感到困惑?
  3. 情感体验: 关键时刻是否打动读者?结局是否令人满意?主题是否清晰?

常见问题: 动机不清 | 节奏拖沓 | 情节转折缺乏铺垫 | 令人困惑

如果读者理解困难: 找出缺口 → 返回阶段 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 - 场景级分析模板

评论

支持 Markdown