mcpField
A
academic-chapter-writer

academic-chapter-writer

github.com/drshailesh88文档处理659 次安装24 周前更新
代码仓库

关于 academic-chapter-writer

academic-chapter-writer 是按研究、规划、撰写和汇编流程生成教材章节的技能,面向需要基于 PubMed 文献、采用 Vancouver 引用格式并设置审核节点的学术作者。

主要功能

  1. 01搜索 PubMed 并整理参考文献
  2. 02按字数规划章节目录
  3. 03分节撰写并添加编号引文
  4. 04汇编 Vancouver 格式参考文献
  5. 05等待批准并分阶段审核

适用场景

  1. 01根据主题撰写教材章节
  2. 02在起草前整理研究文献
  3. 03分阶段审核章节结构和内容

MCP 相关

工作流要求 Agent 使用 PubMed MCP 搜索文章并获取文章元数据,再以这些结果支持带引文的章节写作。

安装

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

$npx skills add https://github.com/drshailesh88/integrated_content_os --skill academic-chapter-writer

安装后在 Claude Code 中输入/academic-chapter-writer确认已加载。

附带文件references/writing-style.md

详细介绍

学术章节撰写工具

将主题转化为可发表的教科书章节,包含全面的研究、恰当的引用和自然流畅的学术文风。

概述

此技能通过 Agent 工作流撰写完整的学术教科书章节(5,000-15,000 字):

  1. 研究 - 搜索 PubMed,整理 20-30 篇重要参考文献
  2. 规划 - 生成详细目录并分配字数 → 获取批准
  3. 撰写 - 分章节撰写并附上引用
  4. 编纂 - 汇总完整章节,并附上 Vancouver 格式的参考文献列表

工作流

阶段 1:主题分析与研究

用户提供主题时:

  1. 明确范围:

    • 主题:[准确主题]
    • 层级:本科 | 研究生 | 专业 | 高级
    • 目标长度:[默认 8,000 字]
    • 特别关注点:[具体侧重点]
  2. 通过 PubMed MCP 进行研究:

    Use PubMed:search_articles for:
    - Main topic + "review" (find reviews)
    - Main topic + "clinical trial" (find trials)
    - Main topic + "guideline" (find guidelines)
    - Main topic + "meta-analysis" (find syntheses)
    
  3. 整理参考文献库:

    • 目标为 20-30 篇论文
    • 优先选择:NEJM、JAMA、Lancet、JACC、Circulation、EHJ
    • 纳入:3-5 项里程碑式试验、2-3 篇荟萃分析、1-2 部指南及综述
  4. 向用户汇报: “我已搜索 PubMed 并整理了 [N] 篇重要参考文献,其中包括:

    • 项里程碑式试验
    • 篇荟萃分析
    • 部指南/篇综述

    是否可以开始生成目录?”

阶段 2:生成目录

生成结构化目录并分配字数:

# [Chapter Title]

## 1. Introduction (~500 words)
   - Opening hook (clinical scenario)
   - Scope and importance
   - Chapter overview

## 2. [Historical Context / Background] (~800 words)
   - Evolution of understanding
   - Key milestones
   - Current landscape

## 3. [Core Topic Area 1] (~1,500 words)
   ### 3.1 [Subtopic A]
   ### 3.2 [Subtopic B]
   ### 3.3 [Subtopic C]

## 4. [Core Topic Area 2] (~1,500 words)
   ### 4.1 [Subtopic A]
   ### 4.2 [Subtopic B]

## 5. [Evidence Review / Clinical Data] (~2,000 words)
   ### 5.1 Landmark Trials
   ### 5.2 Meta-analyses
   ### 5.3 Real-world Data

## 6. [Practical Applications / Clinical Pearls] (~1,000 words)
   ### 6.1 [Application A]
   ### 6.2 [Application B]

## 7. [Controversies / Ongoing Debates] (~500 words)

## 8. Future Directions (~400 words)

## 9. Conclusions (~300 words)
   - Key takeaways
   - Practice implications

## References

关键:等待用户批准

展示目录并询问: “这是建议的章节结构,总计约 [X] 字。请审核并:

  • [批准] 继续撰写
  • [修改] 指定章节
  • [重新生成] 更换方案”
阶段 3:撰写章节

目录获批后,按照以下模式撰写每个章节:

每个章节的撰写规范
  1. 检索相关参考文献 - 使用 PubMed:get_article_metadata 获取与章节相关的论文信息
  2. 采用真实自然的文风 - 严格遵循 references/writing-style.md
  3. 添加引用 - 按顺序编号为 [1]、[2] 等
  4. 符合目标字数 - 控制在 ±10% 范围内
  5. 提交审核 - 每完成一个主要章节后提交审核
章节模板
## [Section Title]

[Opening sentence that grounds reader - specific, concrete, not abstract claims]

[Body paragraphs with citations. Each major claim cited. Mix of sentence lengths. No AI tells.]

[Transition to next section or closing thought]

**Citations used in this section:** [1] Author et al., Journal Year; [2] ...
引用格式(Vancouver)

正文引用:顺序编号 [1]、[2]、[1,3]、[4-6]

参考文献列表格式:

1. Author AA, Author BB, Author CC. Title of article. Journal Abbrev. Year;Volume(Issue):Pages. doi:xxx
阶段 4:编纂

所有章节均获批准后:

  1. 合并章节 - 确保过渡自然流畅

  2. 编排引用编号 - 在整章中按顺序编号

  3. 生成参考文献列表 - 使用 Vancouver 格式并编号

  4. 检查格式:

    • 所有引用编号均出现在参考文献列表中
    • 标题样式一致
    • 没有未被引用的参考文献
    • 字数统计摘要
  5. 提交最终章节:

    # [Chapter Title]
    
    [Full content with numbered citations]
    
    ## References
    
    1. [Reference 1]
    2. [Reference 2]
    ...
    
    ---
    Total words: X,XXX
    Total references: XX
    

写作风格(关键)

Eric Topol 文风原则
  1. 以证据为重 - 每项论断都有引用研究支撑
  2. 审慎乐观 - 对进展充满热情,同时保持严谨
  3. 以患者为中心 - 回归对人的影响
  4. 深入浅出 - 清晰解释复杂的科学内容
  5. 对话式权威感 - 像同侪交流,而不是讲课
  6. 数据可视化 - NNT、ARR、置信区间
自然文风规则

绝不使用以下 AI 痕迹:

  • 拖尾分词(“……突显了……的重要性”)
  • 夸大重要性(“这代表着一项重大进展……”)
  • 否定式平行结构(“这不只是 X,而是 Y”)
  • 幽灵式语言(低语、回响、织锦)
  • 夸张宣传用语(依偎于、令人叹为观止、充满活力)

务必做到:

  • 以具体事实开篇,而非抽象论断
  • 显著改变句子长度
  • 使用“说”或“显示”,而不是“强调”或“突显”
  • 每段最多使用一个 em dash
  • 不要使用谄媚式开场白

词汇替换:

  • delve → examine、look at
  • leverage/utilize → use
  • landscape → field、area
  • tapestry → mix、blend
  • pivotal/crucial → [说明其重要性]
  • comprehensive → thorough、full
  • nuanced → subtle、detailed
  • foster → build、encourage
  • navigate → handle、work through
语气检查清单(适用于每个部分)
  • 没有未经证据支持就声称某事很重要的句子
  • 具体细节多于抽象描述
  • 句子长度有所变化(短句、中句和长句交替)
  • 每个段落中的破折号不超过一个
  • 开头不以“In today's...”或“In the realm of...”起句
  • 句末没有声称某事意义重大的“-ing”短语
  • 没有任何事物“stand as a testament”
  • 所有论断均有引用

参考文献管理

来源优先级

第 1 级(最高):

  • New England Journal of Medicine
  • JAMA
  • Lancet
  • BMJ

第 2 级(专科):

  • European Heart Journal
  • JACC(所有变体)
  • Circulation(所有变体)
  • JAMA Cardiology/Oncology 等

第 3 级(领域专属):

  • 影响因子(IF)> 5 的专科期刊
引用要求
章节长度最少参考文献数
5,000 字15-20
8,000 字20-30
12,000 字30-40
15,000 字40-50
何时询问用户
  • “我需要 [TRIAL NAME] 的全文来了解详细方法。您有吗?”
  • “为了正确理解 [TOPIC],我是否应该搜索特定试验?”
  • “摘要没有提供 [DETAIL]。我应该在缺少该信息的情况下继续,还是您可以提供?”

交互示例

示例 1:新章节请求

用户:“撰写一章关于心力衰竭中 SGLT2 抑制剂的教科书内容”

回复: “我将撰写一章关于心力衰竭中 SGLT2 抑制剂的教科书内容。首先,请确认:

  1. 目标读者的水平?(专业人士/研究生/高级)
  2. 目标篇幅?(默认:8,000 字)
  3. 是否有特定重点?(机制、临床试验、患者筛选,还是全部?)

您回复期间,我会先在 PubMed 中搜索关键参考文献,包括 DAPA-HF、EMPEROR-Reduced 和近期的荟萃分析。”

[使用 PubMed:search_articles]

示例 2:目录展示

研究完成后的回复: “我汇总了 28 篇关键参考文献,分别来自 NEJM(6 篇)、Lancet(4 篇)、JACC(8 篇)、Circulation(5 篇)和 EHJ(5 篇)。

以下是建议的结构:

心力衰竭中的 SGLT2 抑制剂:全面综述

1. 引言(约 400 字)

2. 作用机制(约 1,000 字)

  • 2.1 糖尿效应
  • 2.2 血流动力学效应
  • 2.3 心脏重构

3. 临床证据(约 2,500 字)

  • 3.1 DAPA-HF
  • 3.2 EMPEROR-Reduced
  • 3.3 DELIVER
  • 3.4 荟萃分析

4. 患者筛选(约 1,200 字)

  • 4.1 HFrEF
  • 4.2 HFpEF
  • 4.3 特殊人群

5. 实际应用(约 1,000 字)

6. 安全性注意事项(约 800 字)

7. 未来方向(约 600 字)

8. 结论(约 500 字)

总计:约 8,000 字 | 参考文献:28 篇

[批准] [修改] [重新生成]”

示例 3:交付章节

章节完成后的回复: “## 3. 临床证据

SGLT2 抑制剂在心力衰竭领域的临床开发经历了一条出乎意料的路径。这些药物最初获批用于控制糖尿病患者的血糖,后来在安全性试验中展现出显著的心血管获益,促使研究者开展专门针对心力衰竭的研究 [1,2]。

3.1 DAPA-HF

DAPA-HF 试验将 4,744 名射血分数降低的心力衰竭患者随机分配至达格列净 10mg 组或安慰剂组 [3]。在中位随访 18.2 个月后,达格列净使心力衰竭恶化或心血管死亡这一主要复合终点降低了 26%(HR 0.74,95% CI 0.65-0.85)[3]。这种获益在数周内显现,并且不受糖尿病状态影响;这一发现改变了临床医生对这类药物的理解 [4]。

[后续内容约 800 字,含 8-10 条引用]


**本节字数:**823 引用:[1-10]

准备继续第 3.2 节(EMPEROR-Reduced)吗?[继续] [修改本节]”

最终交付前质量检查清单

  • 所有章节均已包含且完整
  • 总字数在目标字数的 ±10% 以内
  • 所有引文均按顺序编号
  • 参考文献列表与文中引文一致
  • 不含 AI 痕迹(已根据真实语气规则检查)
  • 各章节之间的过渡流畅
  • 开篇引人入胜(而非泛泛而谈)
  • 结论具体(而非空洞的陈词滥调)
  • Vancouver 引用格式一致

输出格式

最终章节交付如下:

# [Chapter Title]

**Author:** [User name if provided]
**Word Count:** X,XXX
**References:** XX

---

[Full chapter content with [numbered] citations]

---

## References

1. [Full Vancouver-format reference]
2. [Full Vancouver-format reference]
...

评论

支持 Markdown