paper-backup-before-word

name	paper-backup-before-word
description	在编辑任何 .docx / Word 文件之前，必须先用 cp 创建带时间戳的备份副本， 并优先评估"用 markitdown 转 LaTeX 后再改"是否更安全； 只有在确认必须直接编辑 .docx 时才动手，且改完后必须提醒用户先打开 Word 验证完整性。 Use when 用户请求修改、润色、改写、重排任何 .docx 文件、 或调用 /docx skill、或 Edit/Write 操作目标是 .docx 文件时。

paper-backup-before-word：改 Word 之前必先备份

核心理念

.docx 是个 zip 包。一旦写崩 XML，整份文件打不开，所有批注、修订、格式全部消失。 书里第 8 章记录了两次惨案：一次覆盖原文件、一次 XML 损坏——两次都是没备份。

Word 文件不是文本文件。它的每一次写操作都是一次"打开心脏手术"。

---

强制规则

编辑任何 .docx 之前必须执行下列三步，缺一不可：

1. cp 创建带时间戳的备份
2. 评估是否值得"先转 LaTeX 再改"
3. 改完后告诉用户"第一件事打开 Word 验证完整性"

---

触发条件

满足任一条 → 触发：

• 用户请求修改 / 润色 / 改写 / 重排某 .docx 文件
• 用户的指令里出现 "Word"、".docx"、"文档"、"批注"
• 你即将调用 /docx skill 的 modify / write 类操作
• 你即将对路径以 .docx 结尾的文件调用 Edit / Write
• 用户说"导师在 Word 里批注了，帮我改一下"

---

强制流程

检测到 .docx 编辑请求
        │
        ▼
第 1 步：创建备份
  cp "原文件.docx" "原文件.bak.YYYYMMDD-HHMMSS.docx"
        │
        ▼
第 2 步：判断是否值得转 LaTeX（见决策表）
  ├─ 主稿大改 / 长期项目 → 建议转 LaTeX
  └─ 导师批注小修 / 一次性改 → 直接改 .docx
        │
        ▼
第 3 步：执行修改
        │
        ▼
第 4 步：交付时告诉用户
  「改完了，请你**先打开 Word 验证一下能正常打开**，
   有问题立刻回滚到 [备份文件名]。」

---

备份命名规范

cp "第三章.docx" "第三章.bak.$(date +%Y%m%d-%H%M%S).docx"

格式：<原名>.bak.<时间戳>.docx

禁止：

• 命名为 第三章_备份.docx（无时间戳，下次会覆盖）
• 命名为 第三章 (副本).docx（系统默认名字会冲突）
• 不留备份就开始改

---

"转 LaTeX 还是直接改" 决策表

情况	推荐
主稿、长期写作、还要改 ≥ 5 次	转 LaTeX（一劳永逸）
导师在 Word 里批注，只改这一次	直接改 .docx
涉及大量公式 / 表格重排	转 LaTeX
涉及 Track Changes 修订 / 批注，必须保留	直接改 .docx
投稿要求必须 Word 模板	直接改 .docx，但保留 LaTeX 草稿

---

❌ 反例（书 §8.1）

惨案 1：用户要改第 4 章，AI 直接 Write 覆盖原文件——原稿+导师批注全丢。 惨案 2：AI 调用 /docx 修改样式，写崩了 XML，整个文件打不开。

两次的共同根因：没备份就动手。

---

Rationalization Table

念头	现实
"用户的 Mac 有 Time Machine 自动备份"	Time Machine 的快照是按小时的，可能正好没覆盖到这一刻
"git 已经在跟踪这个文件"	git 不识别 .docx 内部 XML 状态，损坏后 diff 也救不了
"我只改一个段落，不会出问题"	惨案 2 就是改一个段落崩的 XML
"备份占空间"	一个 .docx 几 MB，对比丢稿损失忽略不计
"用户说要快"	"快" ≠ "不备份"，备份只要 0.5 秒
"上次改这个文件备份过了"	上次的备份不是这次的备份

---

Red Flags

• 你即将对 .docx 调用 Edit / Write，但还没 cp → 停
• 你想"先试试看，不行再说" → 不行，备份是先决条件
• 你看到目录里有 .bak 文件就觉得"已经有备份了" → 不一定是这次的备份，按规范重新备份
• 改完不提醒用户验证完整性 → 不算交付完成

---

来源

《Claude Code 科研手记》§8.1「Word 文档操作的风险」、§8.2「备份策略」