mcpField
W
writing-revision

writing-revision

github.com/lyndonkl创意与媒体18786 次安装9 周前更新
代码仓库

关于 writing-revision

面向希望系统修改草稿的写作者,将编辑分为三轮:删减冗余、降低认知负担和改善节奏。流程要求先分析全文,再据此修改并核对字数变化。

主要功能

  1. 01三轮修改流程
  2. 02删减冗余并统计字数
  3. 03检查认知负担
  4. 04改善句子节奏
  5. 05为各轮生成分析文件

适用场景

  1. 01在保留原意的前提下修改草稿
  2. 02将草稿篇幅缩减 10–25%
  3. 03找出需要反复阅读的句子
  4. 04改善文章流畅度和句式变化

安装

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

$npx skills add https://github.com/lyndonkl/claude --skill writing-revision

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

附带文件resources/evaluators/rubric_revision.jsonresources/revision-guide.md

详细介绍

写作修订(三遍系统)

目录

相关技能: 使用 writing-structure-planner 规划结构,使用 writing-stickiness 打造令人难忘的信息,使用 writing-pre-publish-checklist 完成最终发布检查。

核心原则

  1. 每遍只关注一个方面:每遍针对一个维度进行修改,而不是一次性修复所有问题
  2. 删减 10-25%:King 的公式——第二稿等于第一稿减去 10-25%
  3. 每个词都有存在的价值:如果一个词没有贡献,就删掉它
  4. 第一遍读懂才算读懂:读者不应该需要重读句子(Pinker)
  5. 节奏能带来投入感:长短不一的句子和有力的结尾能让读者持续读下去

工作流

复制此清单并跟踪进度:

Three-Pass Revision:
- [ ] Pass 1: Cut clutter (analyze -> improve)
- [ ] Pass 2: Reduce cognitive load (analyze -> improve)
- [ ] Pass 3: Improve rhythm (analyze -> improve)

开始前: 查看 resources/revision-guide.md,了解完整的三遍系统、示例和完整的改写演示。

每一遍都要先分析整篇初稿,并将分析结果输出到当前目录中的分析文件,然后阅读该文件进行修改。这样可以确保检查全面。

第 1 遍:删减冗余(Zinsser/King)

目标: 将字数删减 10-25%。让每个词都有存在的价值。

步骤 1.1 - 分析:通读整篇初稿。创建分析文件 writer-pass1-clutter-analysis.md,标出所有以下内容:副词(以 -ly 结尾的词)、限定词(very、really、quite、somewhat)、被动语态、弱动词(is、are、was、were、has/have/had)、铺垫性短语和陈词滥调。计算字数,并设定 10-25% 的删减目标。

步骤 1.2 - 改进:阅读分析文件。通读整篇初稿并进行修改:删去 70% 的副词,删除限定词,将被动语态改为主动语态,用动作动词替换弱动词,删去铺垫性内容和陈词滥调。确认字数减少量达到 10-25% 的目标。确保每个保留下来的词都有存在的价值。

详细示例请参阅 resources/revision-guide.md - Pass 1。

第 2 遍:降低认知负荷(Pinker)

目标: 让阅读毫不费力。读者第一遍读就应该能读懂。

步骤 2.1 - 分析:通读整篇初稿。创建分析文件 writer-pass2-cognitive-load-analysis.md,标出所有问题:歧义误导句(暂时误导读者的句子)、被埋没的话题、主谓宾之间相隔超过 7 个词、指代不明确、话题链断裂,以及需要重读的句子。

步骤 2.2 - 改进:阅读分析文件。通读整篇初稿并进行修改:修正歧义误导句,在每个句子开头点明话题,让主谓宾彼此靠近,明确指代,修复话题链,拆分过于复杂的句子。大声朗读,确认读起来流畅。

详细示例请参阅 resources/revision-guide.md - Pass 2。

第 3 轮:改善节奏(Clark)

**目标:**通过变化多样的句式和有力的结尾,打造引人入胜的行文节奏。

第 3.1 步 - 分析:通读全文草稿。创建分析文件 writer-pass3-rhythm-analysis.md,分析:每个段落的句子长度(列出实际长度)、单调的模式(连续 5 个或更多长度相近的句子)、每个句子的最后一个词(标出软弱的结尾)、精彩点的分布(找出缺少精彩点的地方)、运用抽象层次阶梯的机会(具体 -> 一般 -> 具体),以及缺乏变化的部分。

第 3.2 步 - 改进:阅读分析文件。通读全文草稿并逐一处理:在较长句子后加入短句以加强语气;将软弱的句子结尾替换为有力的词语;在全文中分布精彩点(尤其是在中段);运用抽象层次阶梯;有意识地改变句子长度。大声朗读以确认行文流畅。确认短、中、长句搭配得当。

详细示例请参阅 resources/revision-guide.md - Pass 3。

使用 resources/evaluators/rubric_revision.json 进行评估。最低标准:平均分 >= 3.5。

各轮概览

轮次重点方法目标
第 1 轮冗余Zinsser/King将字数减少 10-25%
第 2 轮认知负担Pinker无需重读
第 3 轮节奏Clark句长多样,结尾有力

注意事项

要求:

  1. 保留含义:删减或重组时,保留作者的原意
  2. 先分析再改进:始终先创建分析文件,再根据分析结果进行改进
  3. 全面覆盖:每一轮都要分析全文草稿,而非只分析前几段
  4. 衡量删减幅度:在第 1 轮跟踪实际字数减少量(目标为 10-25%)
  5. 大声朗读:第 2 轮和第 3 轮结束后,通过大声朗读检查拗口之处和节奏

常见陷阱:

  • 试图在一轮中解决所有问题(每轮只专注一个重点)
  • 只修改开头几段,后续便失去动力
  • 删减过度,导致文风丢失
  • 不跟踪实际字数减少量
  • 跳过分析阶段,直接开始编辑

快速参考

关键资源:

所需输入:

  • 待修改的草稿文本(任何阶段)
  • 用户的意图或核心信息(如已知)
  • 任何约束(目标字数、语气偏好)

生成的输出:

  • 每一轮的分析文件(冗余、认知负担、节奏)
  • 标注字数减少量的修订稿
  • 每一轮所做更改的摘要

评论

支持 Markdown