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

paper-claude-md-bootstrap

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

Repo
Chanw-research/claude-code-paper-writing
Slug
paper-claude-md-bootstrap

SKILL.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 模板

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

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

## 投稿目标
- 期刊 / 会议:[名称]
- 字数:[限制]
- 格式:[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 章「上下文与记忆」

同一分类的其他项