| name | rw-revision-patch |
| metadata | {"internal":true} |
| description | 将 Markdown 文稿切成带稳定 ID 和 hash 的段落块，只对用户批准的块执行替换，并输出保留比例、修改理由和问题追踪报告。Use when the user asks for“只改这几段”“按审稿意见局部修改”“保留其他内容不动”“生成可复核修改 patch”,or requests the rw-revision-patch workflow.
|
RW Revision Patch
限制修改范围。第一版只替换已有 Markdown 块，不静默增加、删除或重排章节。
启动
- 读取
references/method.md 和 references/patch-format.md。
- 保留原始文稿，运行
scripts/revision_patch.py anchor 生成带块 ID 的副本和 manifest。
- 根据已批准的修改范围建立 Patch JSON。
- 运行
check，确认 hash、块 ID、修改比例和问题 ID。
- 运行
apply 生成新文稿和报告。
- 对修改块复核内容，对未修改块核对 preserved ratio。
命令
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。
工作阶段
- 固定基础文稿和版本 hash。
- 把标题、段落、列表或代码块按空行边界编号。
- 先确定每条批注对应的完整论证单位。批注框选的词句只是问题位置，不自动等于修改边界；必要时把同段前后句纳入同一 replace。
- 将每项修改连接到块 ID、旧 hash、理由和 issue ID。需要跨块、增删或重排时，先说明范围并转入相应流程。
- 先验证所有操作；任意一项失败时不生成部分结果。
- 生成新文件，不覆盖原文件。
- 输出修改块、保留块、保留比例和新 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。
