$npx -y skills add Lambenthan/paper-discipline-skills --skill paper-claude-md-bootstrap开始任何新的论文写作项目时(新建项目目录、第一次开会话、还没有 CLAUDE.md 文件), 在写任何论文内容、改任何文件之前,必须先帮用户建一份项目级 CLAUDE.md, 把研究主题、投稿目标、术语保护清单、文件结构、写作风格、导师偏好这六项写清楚。 Use when 用户说"开始写新论文"、"新开一个项目"、"帮我写第 X 章"且项目目录里没有 CLAUDE.md 时。
| 1 | # paper-claude-md-bootstrap:新论文项目第一件事 |
| 2 | |
| 3 | ## 核心理念 |
| 4 | |
| 5 | CLAUDE.md 是项目的"永久记忆"。第一天花 5–10 分钟写好,能省下后面每次会话开头 10 分钟的"我先解释下背景..."。 |
| 6 | 书里的真实数据:写过 CLAUDE.md 的项目和没写的,AI 的回应质量差距能拉开两个量级。 |
| 7 | |
| 8 | > 没有 CLAUDE.md 的项目 = 每次开会话都在和健忘的实习生从头讲一遍论文。 |
| 9 | |
| 10 | --- |
| 11 | |
| 12 | ## 强制规则 |
| 13 | |
| 14 | **进入新项目目录第一件事**:用 `ls` 检查是否有 `CLAUDE.md`。 |
| 15 | |
| 16 | - 没有 → 立即停下当前任务,先和用户一起建一份 |
| 17 | - 有但 < 30 行(空模板)→ 同上 |
| 18 | - 有且完整 → 先 Read 完,再回答任何问题 |
| 19 | |
| 20 | 不要"先做用户当下要的事,回头再补 CLAUDE.md"。回头永远不会到。 |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## 触发条件 |
| 25 | |
| 26 | 满足任一条 → 触发: |
| 27 | |
| 28 | - 用户说"开始写新论文"、"新开一个项目"、"帮我写第 X 章" |
| 29 | - 当前工作目录里没有 `CLAUDE.md` |
| 30 | - 当前工作目录里有 `CLAUDE.md` 但 < 30 行 |
| 31 | - 用户说"我有篇论文..."、"我研究的是 XX" 而你不知道任何项目背景 |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ## 强制流程 |
| 36 | |
| 37 | ``` |
| 38 | 检测到无 CLAUDE.md |
| 39 | │ |
| 40 | ▼ |
| 41 | 告诉用户:「在动手之前,先花 5 分钟把 CLAUDE.md 建起来—— |
| 42 | 后面每次开会话能省下你重复解释的时间。」 |
| 43 | │ |
| 44 | ▼ |
| 45 | 按下方"必问的六项"逐项问用户 |
| 46 | (一次问一项,不要一口气列六个,避免用户视觉疲劳直接答"都行") |
| 47 | │ |
| 48 | ▼ |
| 49 | 全部答完 → Write 工具落盘 CLAUDE.md |
| 50 | │ |
| 51 | ▼ |
| 52 | 回到用户最初的任务 |
| 53 | ``` |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## 必问的六项 |
| 58 | |
| 59 | | # | 字段 | 提问示例 | |
| 60 | |---|---|---| |
| 61 | | 1 | **研究主题** | "一句话说清你这篇论文研究什么、回答什么问题" | |
| 62 | | 2 | **投稿目标** | "投哪个期刊 / 会议?字数限制?格式(GB/T 7714 / APA / IEEE)?截稿日?" | |
| 63 | | 3 | **术语保护清单** | "哪些专业术语 / 缩写 / 自定义命名是必须保留的?防止我同义替换" | |
| 64 | | 4 | **文件结构** | "主稿在哪?参考文献在哪?图表在哪?draft / revision 怎么命名?" | |
| 65 | | 5 | **写作风格** | "第一人称还是第三人称?被动还是主动?紧凑还是详尽?" | |
| 66 | | 6 | **导师偏好** | "导师特别在意什么?逻辑线 / 引文密度 / 图表规范 / 口语化?有没有禁忌?" | |
| 67 | |
| 68 | --- |
| 69 | |
| 70 | ## CLAUDE.md 模板 |
| 71 | |
| 72 | ```markdown |
| 73 | # [论文标题简称] 项目说明 |
| 74 | |
| 75 | ## 研究主题 |
| 76 | [一句话说清] |
| 77 | |
| 78 | ## 投稿目标 |
| 79 | - 期刊 / 会议:[名称] |
| 80 | - 字数:[限制] |
| 81 | - 格式:[GB/T 7714 / APA / IEEE / ...] |
| 82 | - 截稿:[日期] |
| 83 | |
| 84 | ## 术语保护清单(不得被同义替换) |
| 85 | - [术语 1]:[全称 / 定义] |
| 86 | - [术语 2]:[...] |
| 87 | |
| 88 | ## 文件结构 |
| 89 | - 主稿:[路径] |
| 90 | - 参考文献:[路径] |
| 91 | - 图表:[路径] |
| 92 | - 备份:[路径] |
| 93 | |
| 94 | ## 写作风格 |
| 95 | - 人称:[第一 / 第三] |
| 96 | - 语态:[主动 / 被动 / 混合] |
| 97 | - 紧凑度:[紧凑 / 详尽] |
| 98 | |
| 99 | ## 导师偏好 |
| 100 | - [X 老师特别在意:...] |
| 101 | - [禁忌:...] |
| 102 | |
| 103 | ## 工作纪律 |
| 104 | - 改 .docx 前必先备份(见 paper-backup-before-word) |
| 105 | - 模糊任务先确认方案(见 paper-confirm-before-doing) |
| 106 | - 跨文件改前列保护术语(见 paper-protect-terminology) |
| 107 | ``` |
| 108 | |
| 109 | --- |
| 110 | |
| 111 | ## ❌ 反例 |
| 112 | |
| 113 | 用户:"帮我写一下第三章。" |
| 114 | **错误**:直接开始写——不知道是什么论文、什么风格、术语是哪些。 |
| 115 | **正确**:「我看你这个目录还没有 CLAUDE.md。我们花 5 分钟先把它建起来,后面每次开会话都不用重新解释——可以吗?」 |
| 116 | |
| 117 | --- |
| 118 | |
| 119 | ## Rationalization Table |
| 120 | |
| 121 | | 念头 | 现实 | |
| 122 | |---|---| |
| 123 | | "用户急着写第三章,先写完再补 CLAUDE.md" | 写完发现术语 / 风格 / 引用格式错了,全部重做 | |
| 124 | | "我可以从已有文件推断出风格" | 推断 ≠ 用户的真实偏好;导师偏好你推断不出来 | |
| 125 | | "另一个会话里告诉过我背景了" | 另一个会话不是这个会话,AI 没有跨会话记忆 | |
| 126 | | "CLAUDE.md 太正式,加重用户负担" | 6 个问题 ≤ 5 分钟 = 之后 50 个会话每次省 10 分钟 | |
| 127 | | "我先写一段试试效果,再让用户决定风格" | 你已经在用某种风格写了,用户的"反馈"会被你已写的内容锚定 | |
| 128 | |
| 129 | --- |
| 130 | |
| 131 | ## Red Flags |
| 132 | |
| 133 | - 你正要开始写章节内容,但还没读 CLAUDE.md → 停 |
| 134 | - 你打算用"通用学术风格"硬写 → 停,先问用户 |
| 135 | - 你想"先写一段试试,他不满意再调风格" → 不行,先建 CLAUDE.md |
| 136 | - 用户没问你要 CLAUDE.md,你也不主动建 → 错,是你的责任主动建 |
| 137 | |
| 138 | --- |
| 139 | |
| 140 | ## 来源 |
| 141 | |
| 142 | 《Claude Code 科研手记》第 2 章「上下文与记忆」 |