# Rw Revision Patch

> 将 Markdown 文稿切成带稳定 ID 和 hash 的段落块，只对用户批准的块执行替换，并输出保留比例、修改理由和问题追踪报告。Use when the user asks for“只改这几段”“按审稿意见局部修改”“保留其他内容不动”“生成可复核修改 patch”,or requests the rw-revision-patch workflow.

- Skill: `ozrwayne/rw-revision-patch` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add ozrwayne/rw-revision-patch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ozrwayne/rw-revision-patch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: ozrwayne (https://skillmd.com/u/ozrwayne)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ozrwayne/rw-revision-patch

---


# RW Revision Patch

限制修改范围。第一版只替换已有 Markdown 块，不静默增加、删除或重排章节。

## 启动

1. 读取 `references/method.md` 和 `references/patch-format.md`。
2. 保留原始文稿，运行 `scripts/revision_patch.py anchor` 生成带块 ID 的副本和 manifest。
3. 根据已批准的修改范围建立 Patch JSON。
4. 运行 `check`，确认 hash、块 ID、修改比例和问题 ID。
5. 运行 `apply` 生成新文稿和报告。
6. 对修改块复核内容，对未修改块核对 preserved ratio。

## 命令

```bash
python3 scripts/revision_patch.py anchor draft.md --output draft.anchored.md --manifest draft.manifest.json
python3 scripts/revision_patch.py check draft.anchored.md --manifest draft.manifest.json --patch revision.patch.json
python3 scripts/revision_patch.py apply draft.anchored.md --manifest draft.manifest.json --patch revision.patch.json --output draft.revised.md --report revision.report.json
```

修改块超过全文 60% 时停止。只有用户明确同意大范围修改后才能加入 `--allow-large-patch`。

## 工作阶段

1. 固定基础文稿和版本 hash。
2. 把标题、段落、列表或代码块按空行边界编号。
3. 先确定每条批注对应的完整论证单位。批注框选的词句只是问题位置，不自动等于修改边界；必要时把同段前后句纳入同一 replace。
4. 将每项修改连接到块 ID、旧 hash、理由和 issue ID。需要跨块、增删或重排时，先说明范围并转入相应流程。
5. 先验证所有操作；任意一项失败时不生成部分结果。
6. 生成新文件，不覆盖原文件。
7. 输出修改块、保留块、保留比例和新 hash。

## 运行规则

- 原文件不被修改。
- Patch 第一版只支持 `replace`。
- 一个块在一次 Patch 中只能修改一次。
- `expected_hash` 必须与 manifest 一致。
- `new_text` 不能包含 RW block marker。
- 任意 precondition 失败时整批停止。
- 未涉及块的正文保持原样。
- 局部批注限制未经批准的改动范围，不要求修改只停留在高亮词句。内容正确性需要在完整论证单位上复核。
- “Expand”“Tell me more”“I don't understand”不能只通过增加字数、例子或同义词关闭。先检查主体、对象、行动、发生环节、作用关系、适用边界和当前意义是否仍需读者猜测。
- 新增、删除、重排章节进入结构修改，不伪装成局部替换。
- Patch 只能限制改动范围，不能证明修改内容正确。

## 输出

- Anchored Markdown 副本。
- Block manifest JSON。
- Patch JSON。
- Revised Markdown 新文件。
- Apply report JSON，包含 preserved ratio 和修改追踪。
- 每条批注的论证单位、修改边界理由和仍未闭合的问题。

## 可选 ADHD 友好输出

- 仅当用户明确要求“ADHD 友好输出”“ADHD 友好模式”或同义方式时启用。
- 不主动询问、介绍或推荐这个模式，不根据表达方式、回复速度或任务完成情况推断。
- 用户只披露有 ADHD，但没有要求改变输出方式时，不启用。
- 默认只在当前任务中保持；用户要求关闭时立即返回普通输出。
- 不保存诊断信息。用户明确要求跨任务保留时，只保存 `interaction_mode: adhd_friendly`。
- 启用后先给“只看这里”：当前任务、用户现在只做的 1 件事和本轮完成标准。
- 多步骤任务再给进度：已完成、当前和待处理；简单回答不生成空栏目。
- 重要但不需要现在处理的内容进入“暂存区”；详细证据放在摘要之后。
- 每轮最多提出 1 个关键问题；必须输入先展示最多 3 项，其余放到后续。
- 加粗当前任务、用户动作、结论和阻断状态；每段不超过 2 处，不加粗整段，不重复加粗同一词。
- 不为缩短输出删除证据边界、未知事项、停止条件或安全提示。
- 用户要求“展开”时提供完整记录，同时保留顶部摘要。
- 中断后先给恢复点，说明上次完成位置、当前状态和下一步，不要求用户重复已提供的信息。

## 停止条件

- 输入文稿没有稳定版本时，不生成 Patch。
- hash、块 ID 或基础文稿不匹配时停止。
- 修改比例超过 60% 且用户没有明确批准时停止。
- 需要新增、删除或重排章节时，改走结构修订流程。
- 解决批注必须跨越用户尚未批准的块时，先报告所需范围，不静默扩大 Patch。

## 接续

- 学术写作：`rw-phd-write`。
- 作者语气：`rw-phd-tone`。
- 审稿回复：`rw-journal-submission`。
- 主张复核：`rw-claim-audit`。