chanw-research/claude-code-paper-writing/paper-claude-md-bootstrap

paper-claude-md-bootstrap：新论文项目第一件事

核心理念

CLAUDE.md 是项目的"永久记忆"。第一天花 5–10 分钟写好，能省下后面每次会话开头 10 分钟的"我先解释下背景..."。 书里的真实数据：写过 CLAUDE.md 的项目和没写的，AI 的回应质量差距能拉开两个量级。

没有 CLAUDE.md 的项目 = 每次开会话都在和健忘的实习生从头讲一遍论文。

强制规则

进入新项目目录第一件事：用 ls 检查是否有 CLAUDE.md。

• 没有 → 立即停下当前任务，先和用户一起建一份
• 有但 < 30 行（空模板）→ 同上
• 有且完整 → 先 Read 完，再回答任何问题

不要"先做用户当下要的事，回头再补 CLAUDE.md"。回头永远不会到。

触发条件

满足任一条 → 触发：

• 用户说"开始写新论文"、"新开一个项目"、"帮我写第 X 章"
• 当前工作目录里没有 CLAUDE.md
• 当前工作目录里有 CLAUDE.md 但 < 30 行
• 用户说"我有篇论文..."、"我研究的是 XX" 而你不知道任何项目背景

强制流程

检测到无 CLAUDE.md
        │
        ▼
告诉用户：「在动手之前，先花 5 分钟把 CLAUDE.md 建起来——
后面每次开会话能省下你重复解释的时间。」
        │
        ▼
按下方"必问的六项"逐项问用户
（一次问一项，不要一口气列六个，避免用户视觉疲劳直接答"都行"）
        │
        ▼
全部答完 → Write 工具落盘 CLAUDE.md
        │
        ▼
回到用户最初的任务

必问的六项

CLAUDE.md 模板

# [论文标题简称] 项目说明
 
## 研究主题
[一句话说清]
 
## 投稿目标
-期刊 / 会议：[名称]
-字数：[限制]
-格式：[GB/T 7714 / APA / IEEE / ...]
-截稿：[日期]
 
## 术语保护清单（不得被同义替换）
-[术语 1]：[全称 / 定义]
-[术语 2]：[...]
 
## 文件结构
-主稿：[路径]
-参考文献：[路径]
-图表：[路径]
-备份：[路径]
 
## 写作风格
-人称：[第一 / 第三]
-语态：[主动 / 被动 / 混合]
-紧凑度：[紧凑 / 详尽]
 
## 导师偏好
-[X 老师特别在意：...]
-[禁忌：...]
 
## 工作纪律
-改 .docx 前必先备份（见 paper-backup-before-word）
-模糊任务先确认方案（见 paper-confirm-before-doing）
-跨文件改前列保护术语（见 paper-protect-terminology）

❌ 反例

用户："帮我写一下第三章。" 错误：直接开始写——不知道是什么论文、什么风格、术语是哪些。 正确：「我看你这个目录还没有 CLAUDE.md。我们花 5 分钟先把它建起来，后面每次开会话都不用重新解释——可以吗？」

Rationalization Table

Red Flags

• 你正要开始写章节内容，但还没读 CLAUDE.md → 停
• 你打算用"通用学术风格"硬写 → 停，先问用户
• 你想"先写一段试试，他不满意再调风格" → 不行，先建 CLAUDE.md
• 用户没问你要 CLAUDE.md，你也不主动建 → 错，是你的责任主动建

来源

《Claude Code 科研手记》第 2 章「上下文与记忆」