用 Claude Code、Codex 写论文:装一个写作方法 skill,大纲、综述、方法章都有章法
写作方法·Sun Oct 11·PCPASS 指南

越来越多同学在 Claude Code、Codex、Cursor 这类 AI 编码助手里写论文。多数人的用法是开一个对话说「帮我写文献综述」,拿到的往往是千篇一律的目录腔:没有范式选择、没有字数配比、没有对照表,方法章只有一句「本研究采用问卷调查法」。问题的根子不在模型,在于助手不知道一套完整的论文写作方法。解法也简单:把方法装进去——一个叫 thesis-writing-craft 的开源 skill(技能包),一条命令安装,装完再说「帮我搭硕士论文大纲」,助手就按高校图书馆指南和期刊出版社公开的方法给骨架,并在成稿后逐节自检。
这个 skill 是什么、不是什么
它是一个装进 AI 助手的论文写作方法库:入口文件加五个方法模块,覆盖搭大纲、找文献、读文献、写综述、写引言摘要、写方法章、缩小选题七类任务,全部方法来自公开可查的来源并在文内逐条标注出处,MIT 协议,放在 GitHub 仓库里可逐条核对。
边界先说清:它管搭结构、找方法、改表达、核格式;不代写、不承诺任何检测结果,涉及字数、格式、送审与 AI 使用规定一律写「以学校和期刊最新通知为准」。成稿的事实与观点由作者本人核实并定稿——这一条和本站其他文章的立场一致(见 AI 起草后怎么交稿)。
装法一:npx skills,一条命令
本机装有 Node.js 时,用开源安装器一条命令装好,它会自动识别你装了哪些助手并让你选择。这个安装器支持约 80 个助手目标,常用的几个及其技能目录如下:
| 助手 | 技能目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex CLI | ~/.codex/skills/ |
| Cursor | .cursor/skills/ |
| GitHub Copilot | .github/skills/ |
两条命令按用途选一条执行:
| 用途 | 命令 |
|---|---|
| 装这个仓库里的全部 skill | npx skills add blackfishdel/pcpass-notes |
| 只装论文写作这一个 | npx skills add https://github.com/blackfishdel/pcpass-notes/tree/main/skills/thesis-writing-craft |
装法二和三:一键脚本、手动复制
没有 Node 的机器只要有 git 也能装。下面三条按环境挑一条:第一条自动找已安装助手的技能目录,有几个装几个;第二条先指定目标再装,参数四选一(claude / codex / zcode / agents);第三行起是手动复制的等价做法。
| 场景 | 命令 |
|---|---|
| 自动检测已装助手 | curl -fsSL https://raw.githubusercontent.com/blackfishdel/pcpass-notes/main/skills/install.sh | bash |
| 指定装给 Claude Code | curl -fsSL https://raw.githubusercontent.com/blackfishdel/pcpass-notes/main/skills/install.sh | bash -s -- claude |
| 手动:克隆后复制 | git clone --depth 1 https://github.com/blackfishdel/pcpass-notes.git /tmp/pcpass-notes 然后 cp -r /tmp/pcpass-notes/skills/thesis-writing-craft ~/.claude/skills/(Codex 换 ~/.codex/skills/,Cursor 换 .cursor/skills/) |
脚本就放在仓库的 skills/install.sh,想在执行前看清每一步可以先读它;卸载等于删掉技能目录里的 thesis-writing-craft 文件夹。
让 AI 助手自己装
AI 编码助手一般都能执行命令,所以还有第四种装法:把一段话直接发给它——
请安装一个 skill:把 GitHub 仓库 blackfishdel/pcpass-notes 里的 skills/thesis-writing-craft 目录克隆下来,复制到你的技能目录(Claude Code 是 ~/.claude/skills/,Codex 是 ~/.codex/skills/,以实际使用的助手为准),装完告诉我怎么触发。
它装完通常会自己复述用法。如果这一步卡住——比如机房电脑没有 Node、或者想先看清脚本再执行——方法笔记站的安装页把四种装法逐步展开,还附了每步装到哪个目录的核对表,照着走即可。
装完怎么说:三类高频请求
装好后正常对话即可触发,说需求就行。三类最常用的请求与它的处理方式:
| 你说 | 它按什么方法做 | 产出什么 |
|---|---|---|
| 导师给的题目太大,帮我缩小 | 三层限定法:对象→变量→场景 | 若干候选题,各附「切口小巧/数据可达/方法匹配」三项评估 |
| 帮我搭硕士论文大纲 | 先选四类范式之一,再给章节骨架 | 大纲加各章字数配比,附「问题↔对策」或「假设↔检验」对照表 |
| 我的综述写成了摘要排队 | 综述四步:收集→分类→评析→整合 | 按研究主题重组的分节结构,每节结尾连回你的研究问题 |
它搭大纲的章法
直接生成的大纲最常见的毛病是「范式错配」:实证型的题目套了问题对策型的五章制。这个 skill 先问数据形态(问卷、实验、访谈,还是拿企业问题做对策),再对号入座四类范式,然后给字数配比——应用型论文的篇幅重心在方案设计章(约 25–30%),绪论一般占 10–15%,摘要 800–1500 字、关键词 3–5 个。配完骨架还有一条硬规则:每个问题必须有针对其成因的对策,实证型则是每条假设都有对应的检验,交稿前把对照表真的画出来核对一遍。方法细节展开在论文大纲怎么搭。
它组织文献综述的章法
综述不是摘要排队。skill 里的做法来自高校图书馆与写作研究中心的公开指南:检索走六步路线(想清楚要找什么→准备关键词→检索→缩小结果→阅读与追踪→规范引用),阅读用三遍法(第一遍 5–10 分钟过标题摘要结论,第二遍约 1 小时抓图表与主旨,第三遍重构论证),只对通过前两层筛选、约占总数 10–20% 的核心文献做全文精读。组织时按研究假设的顺序归类,每小节结尾连回自己的研究问题;引注以必要为限——有论文两万字引文占了三到五成,去掉引文就大幅缩水,属于要避免的形态。展开写法见文献综述怎么组织,综述为什么容易被标高疑似见文献综述 AI 率。
一次实测对照:装之前与装之后
我们用同一个请求做过对照测试:一位管理学硕士生的题目「企业数字化转型研究」,导师评价范围太大。两种处理方式的输出差异如下:
| 项目 | 未装 skill 直接问 | 装上 skill 后问 |
|---|---|---|
| 选题 | 给了一个缩小后的题目,无评估依据 | 三层限定出三个候选题,各附切口、数据、方法三项评估 |
| 大纲 | 五个章节标题,无配比、无对照表 | 实证型六章大纲,含各章百分比与按四万字折算的字数,附「假设↔检验」对照表 |
| 综述建议 | 「多读文献、做好笔记」式泛泛建议 | 给出分节结构与三层筛选数字(粗筛八十到一百二十篇、精读二十五到三十五篇) |
| 自检 | 无 | 逐节过三问清单,未核实内容标「待核实」 |
同一位同学、同一个题目,差别只在助手有没有装方法库。数字说明的是结构完整度的量级,不承诺写作效果。
常见失败组合
| 组合 | 后果 | 怎么避 |
|---|---|---|
| 装了但一直不用,仍直接让它「写一章」 | 输出回到目录腔,白装 | 说需求时带上任务类型(搭大纲/缩选题/改综述) |
| 把 skill 的输出直接当终稿 | 事实未经核实、学校规定未对照 | 产出逐条核对来源;字数格式以学院通知为准 |
| 方法章只写流程套话 | 开题被问「为什么用这个方法」答不上 | 按「做了什么+为什么+数字」重写,见方法章怎么写 |
| 装完不重启助手 | 触发不了,以为没装上 | 装完重启会话再试 |
交稿前打勾清单
| 检查项 | 通过标准 |
|---|---|
| 每节三问 | 读者今天能照着做什么、数字是多少、做错了会怎样,三问都能答 |
| 可核验具体物 | 每节至少一个数字、字段名、文号或样本量 |
| 一一对应 | 问题↔对策或假设↔检验对照表完整,无孤儿项 |
| 事实回溯 | 每条事实说得出来源;说不出的已删除或标注待核实 |
| 引注密度 | 无成段引文,引文占比不挤占正文 |
| 字数配比 | 符合所选范式,重心落在方案或结果章 |
| 规则口径 | 字数、格式、送审要求均注明以学校或期刊通知为准 |
| AI 率自测 | 成稿章节先按学校口径测一段,看清高疑似段再改 |
方法库解决的是「怎么写有章法」,检测与改写的完整链路(自测、按段改写、同口径复测)还是本站的主线:先测一段,看清红段,再决定改什么。两件事一个在前一个在后,都做,稿子才立得住。