mcpField
T
thesis-writing

thesis-writing

github.com/santifs生产力4839 次安装20 周前更新
代码仓库

关于 thesis-writing

面向撰写实证类本科、硕士及博士论文的写作技能,涵盖选题、起草与审阅,并依据学位层级、语言、院校规范和文档格式调整指导。

主要功能

  1. 01选题范围与研究问题
  2. 02章节及小节提纲
  3. 03学术章节起草
  4. 04论文审阅与编辑
  5. 05写作流程规划

适用场景

  1. 01收窄宽泛的论文主题
  2. 02搭建章节提纲
  3. 03起草方法或讨论章节
  4. 04检查结构与学术表达

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/santifs/thesis-writing-skill --skill thesis-writing

安装后在 Claude Code 中输入/thesis-writing确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

review-checklist.md
structure.md
writing-guide.md

详细介绍

撰写论文或学位论文

概述

一篇实证论文围绕一个论点展开,贯穿各个章节:一个值得提出的问题 → 目前已知和未知的内容 → 你的调查方法 → 你的发现 → 这些发现的意义。每章都为下一章铺垫。许多学生最容易草草带过的两个章节,往往决定成绩的高低:界定清晰的研究目的(第 1 章),以及能够回答“那又怎样?”的讨论。

此技能提供五种模式。选择与请求相匹配的模式;必要时可结合使用。如果请求含糊(“帮我写论文/TFG”“我不知道从哪里开始”),或主题尚未明确,就从模式 0 开始——先讨论并界定范围,再列提纲。不要在主题尚不明确时直接搭建章节框架。

参数,请先设定

  1. 学位层级 — 会影响章节数量和深度:
    • 本科论文 / TFG:摘要/Resumen · 引言/Introducción · 文献综述或理论框架/Revisión de la literatura o Marco teórico · 方法论/Metodología · 结果/Resultados · 讨论/Discusión · 结论/Conclusiones · 参考文献/Bibliografía · 附录/Anexos。
    • 硕士论文 / TFM / 博士论文:更完整的实证论文提纲——明确列出竞争性假设、研究范围和假定、内部/外部效度、操作性定义、模拟表格,以及更正式的贡献论证。参见 structure.md。
  2. 语言 — 与文档语言一致。默认使用用户的工作语言,绝不悄然切换语言。
  3. 院校格式 — 如有大学/院系/导师的指南,应遵循这些指南。它们优先于此技能中的通用章节名称和顺序。
  4. 输出格式 — 规划和审阅时默认使用 Markdown/纯文本。只有在用户提出要求,或现有项目已采用相应格式时,才使用 LaTeX、面向 Word 的文本或面向 Google Docs 的文本。

如果缺失的参数会实质性地影响输出,只询问一次,然后采用合理的默认设置继续。

输出格式政策

不要强制使用 LaTeX。论文可以用 LaTeX、Word、Google Docs、Markdown 或其他院校模板写得很好。选择符合作者工作流程和提交要求的格式。

使用 LaTeX 时:

  • 除非用户要求提供完整的文档前言,否则生成可编译的章节/小节片段。
  • 保留现有宏、标签、引用命令、参考文献样式和模板约定。
  • 使用已提供的引用键。如果引用键未知,请使用清晰的占位符,例如 \cite{key_needed},并列出缺少的证据。
  • 除非现有模板有要求,否则不要添加宏包、自定义命令或版式改动。
  • 优先保证文本质量;LaTeX 是交付格式,而非写作方法。

模式

0. 界定主题并确定范围——主题尚不明确时,从这里开始

先提问和讨论,再产出任何内容。 论文的成败取决于目标是否明确;主题模糊会影响后续所有工作。推动对话聚焦于研究问题,而不只是某个领域。每次探讨一两个方面,并复述你听到的内容:

  • 研究问题。 你真正想了解什么?将宽泛的主题逐步聚焦为可研究的问题及子问题。“生物电阻抗与疲劳” 是一个主题;“L-BIA 能否检测急性疲劳及其日积月累的影响?” 才是一个问题。
  • 研究空白。 现有知识体系中有哪些问题尚未得到充分解答?论文正是为填补这一空白而存在。
  • 意义。 谁会受益?既要考虑科学贡献,也要考虑实践或应用价值。(博士论文:对学科作出原创性贡献。)
  • 适配度检查(值得提出的 Edwardson 测试):这个主题是否足以让你投入数月?你会乐意在聚会上向别人解释它吗?它对你的职业发展有帮助吗/能否发展成期刊论文?它的价值是否不会很快过时?
  • 可行性。 你是否已经拥有(或能及时取得)所需数据、样本和仪器,并获得伦理审查委员会(IRB)的批准?如果不能,就果断缩小范围。
  • 了解本地要求。 阅读 1–2 篇往届论文,最好是由你的导师担任主席的论文,以了解预期标准和格式。

此模式的输出:一段简洁明了的研究目的陈述,加上研究问题/假设,以及对研究意义和范围的说明。这段话将成为模式 1 的起点。

1. 拟定提纲/结构

为所选层级生成章节和小节框架。细化到小节层级(通常占一两页)——这样才能确保工作能够完成。为每个小节写一句话,说明该小节要论证什么,而不只是列出主题。为便于移植,默认使用通用英文小节名称;论文若用西班牙语撰写,则添加对应的西班牙语名称,并始终遵循本地规范。各章的完整模板及每章必须包含的内容,请阅读 structure.md。

2. 撰写各节

使用作者真实的数据、研究发现和来源,为指定章节撰写学术文本。以下规则有助于避免最常见的问题:

  • 使用 writing-guide.md 中的写作方法:论点 → 证据 → 解释;主题句 → 展开论述 → 小结;谨慎限定措辞;明确过渡。
  • 文献综述按观点组织,绝不按作者组织。 每个观点先介绍共同的研究脉络,再说明不同之处。综述结尾必须指出已知什么、未知什么——这一空白正是研究问题/假设的依据。
  • 研究发现章节只报告结果——不引用外部文献,不作解释,不写“这意味着”。先报告描述性统计,再按假设提出的顺序进行假设检验,最后报告事后分析。每一项数值结论都必须配有表格或图。
  • 讨论章节负责解释,不要重复结果。 将每项发现与理论框架及实践联系起来。说明局限性,再提出未来研究方向,最后以有力的结尾收束。这是价值最高的章节。
  • 方法章节要说明理由,而不只是描述——说明为何采用该方法、设计和样本,并引用方法学文献。
3. 审阅/编辑

按照 review-checklist.md 完成两轮编辑:

  • 微观层面:拼写、语法、术语一致性、句子/段落结构、词语选择的多样性。
  • 宏观层面:各章之间的逻辑是否连贯?标题是否一致?主要主题之间是否有过渡?是否有内容需要精简或扩展?讨论章节是否真正回答了“所以呢?” 标出研究发现章节中混入的内容(属于讨论章节的解释),以及仅仅串联摘要的文献综述。
4. 流程 / 规划

运用三种流程技巧,让论文写作切实可行:

  • 分段:将整篇论文拆分为小节大小的篇章(每篇一两页),一次专注完成一篇——不要总想着整篇论文。模式 1 中的小节级大纲本身就是分段方案。
  • 安排进度:制定可持续的节奏,例如:大多数工作日写一个新小节(随后查清写作中遇到的小问题);每周留一天润色最近完成的章节;再留一天处理事务——提交章节、预约导师或专家会面、办事。
  • 给予奖励:每次写作结束后,给自己一点小小的愉悦奖励。当每个篇章都有回报时,面对空白页的阻力便会逐渐消散。

此外,还要完成以下收尾工作:提交给导师前先自行编辑(导师不会帮你校对);留出时间让导师至少通读两遍;在答辩前约一周将论文交给委员会;预订答辩室并准备相关表格;做好答辩后修改的准备。不要承诺在一个学期内完成论文的开题和结题——提交前一个学期就应已有实质性进展(例如已经开始收集数据)。

快速参考

章节唯一任务不得包含
引言 / 研究目的陈述研究问题及其重要性(理论和实践意义)含糊的目标、缺乏理论基础
文献综述 / 理论框架按观点综合文献 -> 揭示研究空白 -> 推导假设一连串的文献摘要
研究方法论证并详细说明研究设计、样本、工具和分析方法缺乏论证的方法
研究发现 / 结果按假设顺序报告结果、表格和图示外部文献、解释
讨论结合理论和实践回答“所以呢?”;说明局限性和未来研究方向只是重述结果
结论简洁收尾,以有力的最后一句结束缺乏依据的新主张

常见错误

  • 研究目的过于模糊 → 整篇论文从一开始就有问题。先敲定第 1 章。
  • 讨论 = 换种说法重述研究发现 → 没有回答“所以呢?”。始终联系理论和实践。
  • 在研究发现中夹杂解释 → 保持结果部分纯粹;将含义留到讨论部分。
  • 把文献综述写成注释书目 → 必须逐步引出推动本研究的研究空白。
  • 假设检验顺序错乱 / 没有虚拟表格 → 按假设提出的顺序报告。
  • 忽略竞争性假设(TFM/tesis) → 明确陈述合理的替代解释。

支持文件

  • structure.md — 本科、硕士和博士实证论文的完整分章模板,说明各部分必须包含的内容。
  • writing-guide.md — 关于段落、引文、证据、结果、讨论和 LaTeX 写作模式的实用指南。
  • review-checklist.md — 微观和宏观编辑检查清单,以及实证论文弱项列表。

分享或安装此技能时,请将整个 thesis-writing/ 文件夹放在一起。SKILL.md 依赖通过相对路径引用的支持 Markdown 文件。

评论

支持 Markdown