Paper Claude Md Bootstrap

---
name: paper-claude-md-bootstrap
description: |
  开始任何新的论文写作项目时（新建项目目录、第一次开会话、还没有 CLAUDE.md 文件），
  在写任何论文内容、改任何文件之前，必须先帮用户建一份项目级 CLAUDE.md，
  把研究主题、投稿目标、术语保护清单、文件结构、写作风格、导师偏好这六项写清楚。
  Use when 用户说"开始写新论文"、"新开一个项目"、"帮我写第 X 章"且项目目录里没有 CLAUDE.md 时。
---

# 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
        │
        ▼
回到用户最初的任务
```

---

## 必问的六项

| # | 字段 | 提问示例 |
|---|---|---|
| 1 | **研究主题** | "一句话说清你这篇论文研究什么、回答什么问题" |
| 2 | **投稿目标** | "投哪个期刊 / 会议？字数限制？格式（GB/T 7714 / APA / IEEE）？截稿日？" |
| 3 | **术语保护清单** | "哪些专业术语 / 缩写 / 自定义命名是必须保留的？防止我同义替换" |
| 4 | **文件结构** | "主稿在哪？参考文献在哪？图表在哪？draft / revision 怎么命名？" |
| 5 | **写作风格** | "第一人称还是第三人称？被动还是主动？紧凑还是详尽？" |
| 6 | **导师偏好** | "导师特别在意什么？逻辑线 / 引文密度 / 图表规范 / 口语化？有没有禁忌？" |

---

## CLAUDE.md 模板

```markdown
# [论文标题简称] 项目说明

## 研究主题
[一句话说清]

## 投稿目标
- 期刊 / 会议：[名称]
- 字数：[限制]
- 格式：[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

| 念头 | 现实 |
|---|---|
| "用户急着写第三章，先写完再补 CLAUDE.md" | 写完发现术语 / 风格 / 引用格式错了，全部重做 |
| "我可以从已有文件推断出风格" | 推断 ≠ 用户的真实偏好；导师偏好你推断不出来 |
| "另一个会话里告诉过我背景了" | 另一个会话不是这个会话，AI 没有跨会话记忆 |
| "CLAUDE.md 太正式，加重用户负担" | 6 个问题 ≤ 5 分钟 = 之后 50 个会话每次省 10 分钟 |
| "我先写一段试试效果，再让用户决定风格" | 你已经在用某种风格写了，用户的"反馈"会被你已写的内容锚定 |

---

## Red Flags

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

---

## 来源

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