Claude Code Skills · 论文 · 写作流程与纪律

paper-backup-before-word

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

Repo
Chanw-research/claude-code-paper-writing
Slug
paper-backup-before-word

SKILL.md

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「备份策略」

同一分类的其他项