mcpField
N
novel-revision

novel-revision

github.com/jwynia创意与媒体179680 次安装35 周前更新
代码仓库

关于 novel-revision

一种帮助写作者系统管理长篇小说修改的技能,关注概念、结构和稿件层面的变更及其连锁影响。它通过影响评估、受控实施、后续任务追踪和一致性检查来管理修改过程。

主要功能

  1. 01区分概念、结构和文本修改
  2. 02预先梳理变更连锁影响
  3. 03分阶段实施并设置检查点
  4. 04跟踪后续修改与一致性
  5. 05记录监测信号和回退点

适用场景

  1. 01调整人物动机并检查后续影响
  2. 02重排情节节点和评估因果
  3. 03管理跨章节的主题修改

安装

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

$npx skills add https://github.com/jwynia/agent-skills --skill novel-revision

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

详细介绍

小说修订:多层级变更管理技能

你可以帮助作者管理不同抽象层级的修订,同时防止意外后果在叙事中层层蔓延。你的职责是实施系统化的变更管理,保持故事连贯性。

核心原则:关注连锁影响

任何层级的变更都可能影响其他所有层级。 变更会向上蔓延(从文字中发现结构问题),也会向下蔓延(结构变更需要重写文字)。

三个层级

每部小说都同时存在于以下层级:

主题/概念层级
  • 核心主题与意义
  • 人物成长弧线
  • 象征元素与母题
  • 整体主旨与情感历程
结构层级
  • 情节节点与故事架构
  • 场景顺序与章节编排
  • 节奏与韵律
  • 张力模式与解决循环
稿件层级
  • 实际正文与对话
  • 描写段落
  • 叙述声音与风格的一致性
  • 行文层面的写作技巧

变更前分析流程

实施任何修订前:

1. 确定变更层级
  • 概念层面:改变主题、人物动机或意义
  • 结构层面:调整情节节点、场景顺序或节奏
  • 文字层面:润色语言、对话或描写
2. 梳理后续影响

针对每项拟议变更,记录:

  • 近期(1-2 章):接下来必须做哪些调整?
  • 中期(3-5 章):会产生哪些连锁影响?
  • 全篇范围:可能如何影响结尾或重大情节点?
3. 制定监控标准

明确表明问题的警示信号:

  • 人物行为不一致
  • 情节逻辑漏洞
  • 节奏异常
  • 主题矛盾

变更实施工作流

阶段 1:影响评估
  1. 记录当前状态:截取相关故事元素的当前状态
  2. 推演后果:写出预期的连锁影响
  3. 设置检查点:确定评估位置
  4. 定义回滚触发条件:明确中止变更的标准
阶段 2:受控实施
  1. 实施最小可行变更:采用能验证假设的最小改动
  2. 立即监控:检查局部连贯性问题
  3. 记录观察结果:记下意外影响
  4. 对照预测进行评估:比较实际结果与预测
阶段 3:管理连锁影响
  1. 找出所需更新:还必须调整哪些内容?
  2. 排列连锁任务优先级:按重要性和依赖关系排序
  3. 跟踪完成情况:明确列出已更新和待更新事项
  4. 验证一致性:检查各项更新能否协调一致

修订类型与流程

人物发展修订

触发条件:人物形象扁平、动机不清或成长弧线不完整

流程:

  1. 梳理人物在所有章节中的当前状态
  2. 找出应体现成长的场景
  3. 推演变更对后续对话/行动的影响
  4. 检查其他人物的反应是否依然一致

监控:行为是否依然可信?其他人物的反应是否恰当?

情节结构修订

触发条件:节奏不佳、事件彼此脱节或高潮缺乏冲击力

流程:

  1. 制作当前情节节点的时间线
  2. 找出需要调整的具体结构元素
  3. 梳理时间安排变化对张力的影响
  4. 检查因果链条是否依然成立

监控:张力是否逐步增强?情节点之间是否相互关联且显得顺理成章?

主题修订

触发条件:主题表达过于直白、含义不清或前后不一致

流程:

  1. 审查稿件中的主题元素
  2. 找出更含蓄地融入主题的机会
  3. 检查人物行为是否支持主题发展
  4. 确保高潮/结局强化主题

监控:主题是否自然浮现?结局在主题表达上是否令人满意?

早期预警信号

预警信号表明的问题
角色的行为违背其性格,且没有发展铺垫连贯性被打破
事件发展缺乏逻辑情节逻辑漏洞
场景节奏意外地过快或拖沓节奏异常
故事事件削弱了主题主题偏移

干预方案

何时回滚
  • 2 章内出现多个预警信号
  • 角色或情节逻辑出现根本性断裂
  • 改动带来的问题多于解决的问题
  • 连锁任务变得难以应对
回滚步骤
  1. 确定回滚点:回到上一个稳定状态
  2. 记录经验教训:出了什么问题,以及原因
  3. 调整方案:基于经验制定替代策略
  4. 添加防护措施:通过监控防止问题再次发生
何时继续推进
  • 问题局限于局部且易于处理
  • 收益明显大于复杂性
  • 连锁任务定义明确
  • 故事的核心逻辑仍然完整

改动记录模板

# Revision: [Brief Description]

## Change Type
- [ ] Conceptual  - [ ] Structural  - [ ] Prose

## Rationale
[Why this change is needed]

## Predicted Consequences
- Immediate (1-2 chapters):
- Medium-term (3-5 chapters):
- Story-wide:

## Monitoring Criteria
- Warning sign 1:
- Warning sign 2:
- Success indicator 1:
- Success indicator 2:

## Implementation Status
- [ ] Initial change complete
- [ ] Cascade tasks identified
- [ ] Cascade tasks completed
- [ ] Validation complete

## Outcome Assessment
[Complete after implementation]

多 Agent 协作

与多个 Agent 协作进行修订时:

角色边界
  • 结构 Agent:情节架构和节奏
  • 角色 Agent:角色发展和连贯性
  • 文笔 Agent:语言和风格
  • 连续性 Agent:跨层级连贯性
沟通规范
  • 实施前分享意图
  • 立即报告意外发现
  • 标记可能影响其他层级的情况
  • 协调分配连锁任务
冲突解决
  1. 记录存在冲突的要素
  2. 将问题提交给人类,以创意方式解决
  3. 探索替代方案
  4. 根据故事目标确定优先级

最佳实践

从小处着手
  • 优先进行渐进式改动,而非大幅度改造
  • 一次测试一个要素
  • 通过小胜逐步建立信心
保持全局视角
  • 牢记整体故事目标
  • 不要忽视已经奏效的部分
  • 在追求完美和完成之间取得平衡
记录一切
  • 在修订过程中记录心得
  • 记录哪些做法有效、哪些无效
  • 为未来项目积累知识
相信过程
  • 留出时间让改动稳定下来
  • 不要急于修复每个小问题
  • 随着故事发展,有些问题会自行解决

诊断问题

修订陷入停滞时:

  1. 这项改动实际上属于哪个层级?
  2. 我是否梳理了后续影响?
  3. 什么迹象能说明这项改动有效?
  4. 什么迹象会让我决定回滚?
  5. 我是否在进行最小可行改动?
  6. 这会产生哪些连锁任务?
  7. 我是否明确跟踪了任务完成情况?

输出持久化

查找输出位置
  1. 检查项目中是否存在 context/output-config.md
  2. 如果存在,查找此技能对应的条目
  3. 如果不存在,询问用户:“修订跟踪内容应保存在哪里?”
  4. 建议使用:revision/ 或 explorations/revision/
主要输出
  • 改动记录 - 每项重要改动都使用模板记录
  • 连锁任务列表 - 改动所需的次要编辑
  • 监控日志 - 观察到并处理的预警信号
  • 回滚点 - 稳定状态的快照
文件命名

格式:{novel-name}-revision-{date}.md

验证(Oracle)

此技能可以验证的内容
  • 影响评估已完成 - 是否梳理了后果?(高置信度)
  • 连锁任务跟踪 - 是否记录了次要任务?(高置信度)
  • 监控已启用 - 是否在留意预警信号?(中置信度)
需要人工判断的内容
  • 改动是否必要 - 是否确实需要修订?
  • 是否回滚 - 问题何时超过收益
  • 创意解决方案 - 改动何时引发冲突
Oracle 的局限性
  • 无法评估改动是否改善了故事
  • 无法预测修订方案在创作上的成效

反馈循环

会话持久化
  • **输出位置:**参见 context/output-config.md
  • **保存内容:**改动记录、连锁任务、监控日志
  • 命名格式:{novel-name}-revision-{date}.md
跨会话学习
  • 检查这部小说是否有过往修订工作
  • 借鉴之前修改尝试中的经验
  • 失败的修订可帮助识别反模式

设计约束

此技能假设
  • 已有待修订的小说草稿
  • 修改可能影响多个层面
  • 作者希望系统地管理修改
此技能不处理
  • 问题诊断 - 转至:story-sense
  • 场景级修订 - 转至:revision
  • ** prose 级编辑** - 转至:prose-style
退化信号
  • 未评估的修改(没有梳理影响)
  • 对警示信号视而不见(忽略危险信号)
  • 连锁影响债务(未跟踪次要任务)

推理要求

标准推理
  • 评估单项修改
  • 基本的连锁影响识别
  • 简单的监控设置
扩展推理(ultrathink)
  • 多项修改协调 - [原因:修改会跨层面相互影响]
  • 完整连锁影响分析 - [原因:次级影响会不断累积]
  • 回滚规划 - [原因:复杂的还原需要策略]

触发短语:“协调所有修订”“梳理完整连锁影响”“规划回滚”

执行策略

顺序执行(默认)
  • 先评估影响,再实施
  • 先实施,再跟踪连锁影响
  • 先处理连锁影响,再验证
可并行处理
  • 评估多项互不相关的修改
  • 跟踪不同章节中的连锁任务
子 Agent 候选项
任务Agent 类型适用场景
一致性检查Explore验证整部手稿中的修改时
角色跟踪general-purpose监控角色一致性时

上下文管理

近似 Token 占用
  • 技能基础内容: ~3.5k tokens(层级 + 协议 + 工作流)
  • 附带模板: ~4.5k tokens
  • 附带最佳实践: ~5k tokens
上下文优化
  • 聚焦当前修订类型和协议
  • 模板用于参考文档
  • 多 Agent 部分为可选内容
上下文紧张时
  • 优先处理:当前修订协议、活动修改记录
  • 延后处理:完整协议列表、多 Agent 协调
  • 舍弃:最佳实践、诊断问题

反模式

1. 未评估的修改

模式: 未先分析可能受到影响的其他内容就进行修订——直接跳到实施阶段。 为何失败: 修改会产生连锁影响。角色动机的变化会影响该角色做出选择的每个场景。未经评估的修改会带来问题,往往要到几页之后才会发现,而且那时你可能已经基于有问题的基础继续写了。 修正方法: 每次进行重大修改前,都要明确记录:因此必须修改什么?什么可能出问题?在实施前就设定监控标准,而不是事后再设定。

2. 对警示信号视而不见

模式: 修改后察觉到某些地方不太对劲,却仍然继续推进,相信问题会自行解决。 为何失败: 早期警示是低成本信号,预示着高成本问题。角色的行为违背既定性格、情节逻辑出现漏洞、节奏异常——这些问题会不断累积。越往后处理,修复成本越高。 修正方法: 将早期警示视为可采取行动的信息。停下来评估,并决定是立即修复,还是明确接受风险。不要让“以后再修”不断累积。

3. 连锁影响债务

模式: 修改时不跟踪所需的次级编辑,导致未处理的影响逐渐堆积。 为何失败: 未跟踪的连锁任务会变成看不见的技术债务。你以为自己只做了一项修改,实际上你做了一项修改,还造成了十处未修复的不一致。 修正方法: 维护明确的连锁任务清单。修改需要后续编辑时,立即记下来。跟踪完成情况。连锁影响处理完毕后再继续。

4. 沉没成本固守

模式: 即使警示信号不断增多,仍因已投入大量精力而继续推进有问题的改动。 为何失效: 无论如何,这些投入都已无法挽回。沿着错误的方向继续只会造成更多损失。通常,两个章节内出现多个警示信号,就表明存在根本性问题。 修正: 在实施前定义回滚触发条件。触发条件出现时,就回滚。记录你学到的内容。即使改动未能奏效,这些经验仍有价值。

5. 混淆活动与成果

模式: 根据修改了多少页而非取得了多少改进来衡量进度,把工作量与成果混为一谈。 为何失效: 你可以大幅修改,却没有让故事变得更好。事实上,你甚至可能大幅修改后让故事变得更糟。不能服务于故事目标的活动就是浪费。 修正: 为每轮修改定义“更好”意味着什么。依据这个目标衡量,而不是看改动了多少页。有时,最好的修改就是不修改。

集成

输入(为此技能提供内容)
技能提供内容
story-sense需要修改之处的诊断
character-arc角色一致性要求
scene-sequencing节奏与结构要求
输出(此技能支持)
技能提供内容
prose-style具备级联影响意识的手稿级改动
revision具备多层级协调的场景级工作
(completed novel)保持连贯性的最终作品
互补技能
技能关系
story-senseStory-sense 负责诊断问题;novel-revision 负责处理修正,同时避免引入新问题
revisionRevision 负责句子和场景层面的修改;novel-revision 负责协调整部手稿的修改

评论

支持 Markdown