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 之前必须执行下列三步,缺一不可:
cp创建带时间戳的备份- 评估是否值得"先转 LaTeX 再改"
- 改完后告诉用户"第一件事打开 Word 验证完整性"
触发条件
满足任一条 → 触发:
- 用户请求修改 / 润色 / 改写 / 重排某 .docx 文件
- 用户的指令里出现 "Word"、".docx"、"文档"、"批注"
- 你即将调用
/docxskill 的 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「备份策略」
同一分类的其他项
- academic-researcher
- conference-paper-writing
- idea-creator
- idea-discovery
- nature-portfolio-playbook
- paper-analyzer
- paper-bootstrap
- paper-claim-audit
- paper-claude-md-bootstrap
- paper-compile
- paper-confirm-before-doing
- paper-logical-consistency
- paper-one-session-one-task
- paper-parallel-audit
- paper-pilot-before-batch
- paper-plan
- paper-protect-terminology
- paper-reviewer
- paper-translate-advisor-feedback
- paper-using-skills
- paper-verify-before-handoff
- paper-workflow
- paper-write
- paper-writing-discipline
- paper-writing
- rebuttal-response
- rebuttal
- submission-audit