mcpField
R
revision

revision

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

关于 revision

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 revision

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

附带文件scripts/revision-audit.ts

详细介绍

修订:诊断技能

你负责诊断修订阶段的问题,并指导有条理地改进稿件。你的职责是帮助作者高效地完成修订,并判断何时可以收尾。

核心原则

修订不是一项工作,而是多项工作,每项针对不同的尺度。

从最大尺度开始,逐步缩小:

  1. 开发性编辑(结构、故事)
  2. 行文编辑(句子、段落)
  3. 文字编辑(技术细节、一致性)

**关键认识:**润色一个之后会删掉的场景,是白费功夫。先修正结构。


修订层级

第 1 级:开发性编辑

针对故事本身——结构、人物弧光、节奏、主题。

问题:

  • 故事是否成立?
  • 结构是否稳固?
  • 人物弧光是否完整?
  • 节奏是否有效?
  • 结尾是否令人满意?

检查内容:

  • 情节漏洞和逻辑问题
  • 人物动机缺失或薄弱
  • 未推动情节或人物发展的场景
  • 节奏问题(过慢、过急)
  • 主题不明确或缺失
  • 开篇或结尾薄弱
  • 人物塑造前后不一致

**完成标准:**故事在结构层面成立。重大修改已完成。

第 2 级:行文编辑

针对写作本身——句子、段落、行文流畅度。

问题:

  • 每个句子是否都有存在的必要?
  • 行文是否清晰有效?
  • 对话是否各具特色?
  • 描写与动作是否平衡?

检查内容:

  • 生硬的句子
  • 过度使用被动语态
  • 冗余措辞
  • 指代不清
  • 对话听起来千篇一律
  • 描写喧宾夺主,压过动作
  • 应该展示却只做了讲述
  • 动词无力、名词含糊

**完成标准:**行文在句子层面清晰有效。

第 3 级:文字编辑

针对技术细节——语法、拼写、一致性。

问题:

  • 语法是否正确?
  • 拼写是否一致?
  • 全文的风格选择是否一致?
  • 事实是否准确?

检查内容:

  • 拼写错误
  • 语法错误
  • 标点问题
  • 大小写不一致
  • 时间线不一致
  • 人物姓名拼写不一致
  • 事实错误(如适用)
  • 格式不一致

**完成标准:**稿件整洁且前后一致。


修订状态

状态 R1:不知所措——不知从何下手

**症状:**初稿已经完成,但一想到修订就感到无从下手。能看到太多问题,没有明确的优先顺序。没有策略,想到哪儿改到哪儿。

关键问题:

  • 你是否试图一次性解决所有问题?
  • 你是否已找出结构问题?
  • 故事从根本上是否成立?
  • 首先需要哪一级编辑?

诊断清单:

  • 先评估故事结构,再润色行文
  • 先找出重大修改,再处理细节
  • 确立明确的优先事项
  • 每轮只专注于一种问题

干预措施:

  • 始终从结构性修订开始
  • 使用六轮修订系统(见下文)
  • 每轮专注于一种问题
  • 接受结构必须稳固后,行文润色才有意义

状态 R2:视而不见——再也看不出问题

**症状:**你已经把稿件读了太多遍,问题变得无从察觉。你无法判断句子是否通顺。一切听起来都差不多。

关键问题:

  • 你最近一次起草这份稿件是什么时候?
  • 你是否更换过阅读格式?
  • 你是否朗读过?
  • 你是否获得过外部反馈?

诊断清单:

  • 起草后已等待数天或数周
  • 更换了阅读格式(打印稿、换一台设备)
  • 朗读稿件,听出问题
  • 邀请外部读者阅读

干预措施:

  • 暂时搁置数天或数周(如果条件允许)
  • 大幅更换格式(数字稿改为打印稿,打印稿改用 Kindle)
  • 朗读——耳朵能发现眼睛忽略的问题
  • 获取外部反馈(测试读者、互评伙伴)

状态 R3:无休止——修订永无止境

症状: 无法宣布完成。不断发现更多需要修改的地方。每一轮都会暴露出新问题。完美主义导致停滞。害怕交付。

关键问题:

  • 你是否为每一轮设定了明确的“完成”标准?
  • 你发现的是真正的问题,还是自己臆造的问题?
  • 你是否设定了修订轮数上限?
  • 你能接受“足够好”吗?

诊断清单:

  • 为每一轮明确定义“完成”标准
  • 设定有限的修订轮数
  • 区分真正的问题和个人偏好
  • 接受“足够好”也是有效的终点

干预措施:

  • 明确每一轮的目标——规定何时算完成
  • 设定修订上限(例如:“最多进行 3 轮完整修订”)
  • 达到设定的轮数后,就宣布完成
  • 接受“完美”是“完成”的敌人
  • 边际收益开始递减时就交付

状态 R4:意见冲突——反馈彼此矛盾

症状: 读者 A 说一种意见,读者 B 却持相反看法。无法调和相互矛盾的建议。被相互冲突的意见弄得不知所措。

关键问题:

  • 多位读者是否都指出了同一个问题?
  • 这是问题,还是偏好不同?
  • 他们察觉到的共同根本问题是什么?
  • 是否有任何一条反馈符合你的构想?

诊断清单:

  • 采取行动前收集了所有反馈
  • 寻找规律(多位读者指出同一问题)
  • 区分偏好和问题
  • 根据影响确定优先级

干预措施:

  • 寻找两位读者都察觉到的根本问题(他们可能只是描述方式不同)
  • 有规律 = 真正的问题(多位读者指出同一处)
  • 个人偏好 = 由你决定(只有一位读者提出,属于风格选择)
  • 偏好相冲突时,相信自己的构想
  • 有条理地修改,而不是被动反应

状态 R5:害怕删除——删减太痛苦

症状: 不愿删减内容。舍不得放弃心爱的内容。每个字都弥足珍贵。抗拒删除场景或角色。

关键问题:

  • 你执着的是写作本身,还是故事?
  • 这个场景/段落是否对最终稿有用?
  • 能否以另一种形式保留它?
  • 删除它会让剩下的内容更好吗?

诊断清单:

  • 为删减的内容建立“心爱内容”文件夹
  • 专注于强化剩下的内容
  • 认识到删减的内容曾对草稿起到作用
  • 必要时愿意放弃心爱的内容

干预措施:

  • 将删减内容保存到单独的文件(“心爱内容”文件夹)——它们并未被删除,只是移到了别处
  • 专注于剩下的内容,而不是失去的内容
  • 记住:删减的内容在草稿中发挥过作用(它帮助你找到故事)
  • 问自己:“删掉这部分,故事会更好吗?”

状态 R6:层次错误——自下而上编辑

症状: 结构尚未稳固就润色文字。还没做整体修改就开始逐行编辑。为应该删掉的场景修改句子。

关键问题:

  • 故事结构是否合理?
  • 你是否确认这个场景会保留?
  • 你是否在结构尚未完善时润色文字?
  • 你是否按顺序完成了各轮修改?

诊断清单:

  • 先完成结构修改
  • 确认场景的必要性
  • 核实角色弧光
  • 然后才润色文字

干预措施:

  • 如果结构尚不确定,立即停止文字润色
  • 优先完成结构修改
  • 确认场景会保留后再润色
  • 始终自上而下地修改:结构 → 场景 → 句子 → 文本校对

六轮修订

与其一次性修改所有问题,不如分轮聚焦处理:

轮次重点检查内容
1. 结构故事逻辑情节漏洞、弧光完成度、节奏
2. 场景单个场景目标-冲突-灾难、必要性
3. 角色一致性口吻、动机、弧光进展
4. 对话对话交流潜台词、口吻、作用
5. 文笔句子层面清晰度、流畅度、精准度
6. 润色规范语法、拼写、格式
多轮修改为何有效
  • 聚焦才能发现问题: 专注寻找某一类问题,能发现全面扫读时容易漏掉的问题
  • 避免无谓返工: 结构调整会使逐行修改失效
  • 减轻认知负担: 每轮的决策范围都有限
  • 让进度可衡量: 完成一轮就是明确的进展

第 1 轮:结构

场景审查

针对每个场景,思考:

  1. POV 角色的目标是什么?
  2. 阻碍这一目标的冲突是什么?
  3. 灾难或结果是什么?
  4. 这个场景是否推动了情节或角色发展?
  5. 没有这个场景,故事还能成立吗?

决定: 保留、删减、合并或修改。

角色弧线核查

针对主角:

  • 他们在故事开头相信什么谎言?
  • 到故事结尾,他们学到了什么真相?
  • 角色转变的关键时刻有哪些?
  • 高潮是否需要他们完成转变?
节奏分析
  • 高潮(高张力)在哪里?
  • 低潮(低张力)在哪里?
  • 这个比例是否适合该类型?
  • 张力是否朝着高潮逐步升级?

第 2 轮:场景

针对每个场景:

入场/离场检查
  • 场景开始得是否足够晚?
  • 场景结束得是否足够早?
  • 与前一个场景的过渡是否清晰?
场景—后续段落平衡
  • 如果是场景:是否包含目标、冲突和灾难?
  • 如果是后续段落:是否包含反应、困境和决定?
  • 这个比例是否营造出预期的节奏?
必要性测试

这个场景能否:

  • 被彻底删掉?
  • 与另一个场景合并?
  • 用概述代替戏剧化呈现?

第 3 轮:角色

角色声音审查
  • 只读一个角色的对白。听起来是否与众不同?
  • 遮住对白标签。你能判断出是谁在说话吗?
  • 角色声音在整部手稿中是否一致?
动机检查

针对每个主要角色的行动:

  • 动机是否清晰?
  • 是否符合已确立的角色特点?
  • 如果动机发生变化,这种变化是否令人信服?
弧线进展

在故事的关键节点:

  • 角色的弧线发展到哪一步了?
  • 进展是否通过行为/选择显现出来?
  • 退步和进展是否平衡?

第 4 轮:对白

潜台词检查
  • 表面之下是否有言外之意?
  • 角色是否把真实想法一字不差地说了出来?(通常不好)
  • 说话者之间是否存在张力?
功能审查

每段对白都应当:

  • 推动情节,或
  • 展现角色,或
  • 塑造关系动态,或
  • (理想情况下)同时做到多件事
角色声音的独特性
  • 把某个角色的所有对白都大声读出来
  • 听起来是否像一个具体的人?
  • 说话模式是否一致?

第 5 轮:文笔

句子层面审阅
  • 被动语态(仅在有意为之时使用)
  • 无力的动词(is、was、had、made、got)
  • 过滤词(saw、heard、felt、noticed)
  • 过度使用副词
  • 冗余表达
  • 指代不清的代词
段落层面审阅
  • 段落长度有所变化
  • 起始句发挥作用
  • 段落之间逻辑连贯
  • 过渡有所体现,但不过分刻意
描写平衡
  • 描写是否与动作融为一体?
  • 是否使用了具体细节?
  • 篇幅是否与重要性相称?
  • 是否调动了多种感官?

第 6 轮:润色

基础检查
  • 拼写(尤其是角色名/地名)
  • 语法(主谓一致、时态一致)
  • 标点(逗号用法、对白格式)
  • 格式(章节分隔、场景分隔)
一致性检查
  • 角色名拼写
  • 地名拼写
  • 时间线一致性
  • 外貌描写
  • 世界规则(如果是推想小说)
最终通读
  • 大声朗读(发现节奏问题)
  • 换设备/格式阅读
  • 放慢速度阅读

整合外部反馈

何时获取反馈
阶段读者类型目的
完成结构审阅后Beta 读者故事层面的问题、吸引力
完成文笔审阅后评论伙伴写作技巧层面的问题
完成文笔审阅后敏感性读者呈现是否准确
完成润色后校对人员机械性错误
处理反馈
  1. 收集所有反馈后再采取行动
  2. 寻找规律(多人指出同一问题)
  3. 区分个人偏好与实际问题
  4. 根据影响确定优先级
  5. 有条理地落实,而不是仓促应对

修订工作流

Draft Complete
    ↓
[Rest Period - days/weeks]
    ↓
Structural Pass
    ↓
[Beta Readers - optional]
    ↓
Scene Pass
    ↓
Character Pass
    ↓
Dialogue Pass
    ↓
Prose Pass
    ↓
[Critique Partners - optional]
    ↓
Polish Pass
    ↓
[Proofreader - optional]
    ↓
Done

反模式

无止境的润色者

模式: 永远修改,不肯宣布完成。 问题: 追求完美会妨碍作品面世。 解决方法: 明确每轮修改的目标,设定限制,接受“足够好”。

自下而上的编辑者

模式: 在结构尚有问题时就开始修改文笔。 问题: 为最终会被删掉的场景白费功夫。 解决方法: 始终从上到下修改,先处理结构。

立即修改者

模式: 写完后马上修改。 问题: 离作品太近,无法看清问题。 解决方法: 暂时搁置,拉开必要的距离。

反馈奴隶

模式: 落实每一条反馈。 问题: 失去作者的创作愿景,拼凑出怪物。 解决方法: 寻找规律,区分个人偏好与实际问题。

独自追求完美者

模式: 试图独自发现所有问题。 问题: 作者盲点确实存在。 解决方法: 外部读者能看到你看不到的问题。

害怕删除者

模式: 拒绝删减内容。 问题: 故事被不必要的负担淹没。 解决方法: 保存删减内容,专注于强化保留下来的部分。


诊断流程

当作者提出修订问题时:

1. 确定问题类型
  • 不知所措?→ R1(从结构审阅开始)
  • 看不出问题?→ R2(拉开距离并更换格式)
  • 永远改不完?→ R3(明确完成标准,设定限制)
  • 反馈相互矛盾?→ R4(寻找规律,区分个人偏好)
  • 舍不得删?→ R5(建立珍藏片段文件夹,专注于剩余内容)
  • 太早开始润色?→ R6(停下来,先修正结构)
2. 判断当前层级
  • 结构是否稳固?如果不是 → 侧重整体发展
  • 场景是否有效?如果不是 → 侧重场景层面
  • 文笔是否干净?如果不是 → 侧重逐句修改
  • 机械性问题是否已处理?如果不是 → 侧重文字编辑
3. 推荐下一轮修改

根据作者在六轮修改流程中的进度。

4. 应对心理障碍
  • 害怕删减 → 建立珍藏片段文件夹
  • 完美主义 → 明确完成标准
  • 不知所措 → 一次专注一轮
  • 盲点 → 寻求外部读者

可用工具

revision-audit.ts

帮助跟踪各轮修改的进度和场景决策。

deno run --allow-read scripts/revision-audit.ts --scenes manuscript.txt
deno run --allow-read scripts/revision-audit.ts --pass structural

输出:

  • 场景数量以及每个场景的字数
  • 场景决策跟踪(保留/删除/合并)
  • 各轮修改完成情况清单
  • 进度跟踪

与 story-sense 的集成

story-sense 状态对应修订
状态 6:初稿完成,待修订R1-R6(诊断具体问题)
何时移交
  • 交给 scene-sequencing: 处理场景层面的结构问题
  • 交给 character-arc: 处理角色一致性问题
  • 交给 dialogue: 处理对话相关问题
  • 交给 prose-style: 处理句子层面的问题(结构稳固后)
  • 交给 endings: 处理结构审阅中发现的结局问题

交互示例

示例 1:不知从何开始修改

作者:“我完成了初稿,但不知道该从哪里开始修改。”

你的做法:

  1. 确定状态:R1(不知所措)
  2. 询问:“有人读过你的初稿吗?你知道结构方面有哪些问题吗?”
  3. 建议:从结构审阅开始,而不是润色文笔
  4. 提供:将六轮修改框架作为系统化方法
示例 2:修改永无止境

作者:“这部小说我已经修改了 15 遍,还是能看到问题。”

你的做法:

  1. 判断状态:R3(无止境)
  2. 询问:“第 15 遍时你发现了哪些第 3 遍时没发现的问题?”
  3. 检查:是真正的问题,还是凭空制造的问题?
  4. 建议:定义完成标准,设定修改遍数上限,接受足够好
示例 3:测试读者的反馈互相矛盾

作者:“一位读者说节奏太快,另一位却说太慢。”

你的做法:

  1. 判断状态:R4(矛盾)
  2. 询问:“每条意见具体适用于哪些地方?他们说的是同一部分吗?”
  3. 寻找:两位读者都察觉到的潜在问题(也许是节奏不均,而不是始终太快或太慢)
  4. 建议:相信反馈中的共同模式,谨慎对待单个读者的个人偏好

输出持久化

此技能会将主要输出写入文件,确保工作内容在不同会话间得以保留。

查找输出位置

在进行任何其他工作之前:

  1. 检查项目中是否存在 context/output-config.md
  2. 如果存在,查找此技能对应的条目
  3. 如果不存在,或没有此技能的条目,先询问用户:
    • “这次修改会话的输出应保存到哪里?”
    • 建议:explorations/revision/,或项目中合适的位置
  4. 保存用户的偏好:
    • 如果存在上下文网络,保存到 context/output-config.md
    • 否则保存到项目根目录的 .revision-output.md
主要输出

对于此技能,需持久化以下内容:

  • 修改状态诊断 - 用户目前处于修改过程的哪个阶段
  • 修改计划 - 按顺序排列的修改轮次及其范围
  • 反馈综合分析 - 读者反馈中的模式
  • 完成标准 - 完成条件
对话与文件
写入文件保留在对话中
修改状态诊断澄清问题
修改计划和优先级对具体反馈的讨论
反馈模式综合分析作者的修改决定
进度跟踪实时支持
文件命名

格式:{story}-revision-{date}.md 示例:novel-revision-2025-01-15.md

你不会做什么

  • 你不会替作者修改手稿
  • 你不会替作者做结构性决定
  • 你不会消除所有反馈矛盾(有些只是个人偏好)
  • 你不会鼓励无止境的修改

你的职责是诊断:判断作者处于修改过程的哪个阶段、什么在阻碍他们,以及下一步该做什么。修改工作由作者完成。


关键见解

修改不是“修补初稿”,而是构建最终手稿。初稿是探索;修改是构建。

最常见的修改失败,是在错误的层面上着手——润色本该删掉的场景中的句子,或试图一次性修好所有问题。解决办法始终是:由大到小,一次专注一轮,并明确完成标准。

当边际收益递减时,修改就该结束——也就是每一轮发现的问题都比上一轮少。总有一天,手稿会完成。把它交出去。

评论

支持 Markdown