关于 academic-chapter-writer
academic-chapter-writer 是按研究、规划、撰写和汇编流程生成教材章节的技能,面向需要基于 PubMed 文献、采用 Vancouver 引用格式并设置审核节点的学术作者。
主要功能
- 01搜索 PubMed 并整理参考文献
- 02按字数规划章节目录
- 03分节撰写并添加编号引文
- 04汇编 Vancouver 格式参考文献
- 05等待批准并分阶段审核
适用场景
- 01根据主题撰写教材章节
- 02在起草前整理研究文献
- 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 字):
- 研究 - 搜索 PubMed,整理 20-30 篇重要参考文献
- 规划 - 生成详细目录并分配字数 → 获取批准
- 撰写 - 分章节撰写并附上引用
- 编纂 - 汇总完整章节,并附上 Vancouver 格式的参考文献列表
工作流
阶段 1:主题分析与研究
用户提供主题时:
-
明确范围:
- 主题:[准确主题]
- 层级:本科 | 研究生 | 专业 | 高级
- 目标长度:[默认 8,000 字]
- 特别关注点:[具体侧重点]
-
通过 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) -
整理参考文献库:
- 目标为 20-30 篇论文
- 优先选择:NEJM、JAMA、Lancet、JACC、Circulation、EHJ
- 纳入:3-5 项里程碑式试验、2-3 篇荟萃分析、1-2 部指南及综述
-
向用户汇报: “我已搜索 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:撰写章节
目录获批后,按照以下模式撰写每个章节:
每个章节的撰写规范
- 检索相关参考文献 - 使用 PubMed:get_article_metadata 获取与章节相关的论文信息
- 采用真实自然的文风 - 严格遵循
references/writing-style.md - 添加引用 - 按顺序编号为 [1]、[2] 等
- 符合目标字数 - 控制在 ±10% 范围内
- 提交审核 - 每完成一个主要章节后提交审核
章节模板
## [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:编纂
所有章节均获批准后:
-
合并章节 - 确保过渡自然流畅
-
编排引用编号 - 在整章中按顺序编号
-
生成参考文献列表 - 使用 Vancouver 格式并编号
-
检查格式:
- 所有引用编号均出现在参考文献列表中
- 标题样式一致
- 没有未被引用的参考文献
- 字数统计摘要
-
提交最终章节:
# [Chapter Title] [Full content with numbered citations] ## References 1. [Reference 1] 2. [Reference 2] ... --- Total words: X,XXX Total references: XX
写作风格(关键)
Eric Topol 文风原则
- 以证据为重 - 每项论断都有引用研究支撑
- 审慎乐观 - 对进展充满热情,同时保持严谨
- 以患者为中心 - 回归对人的影响
- 深入浅出 - 清晰解释复杂的科学内容
- 对话式权威感 - 像同侪交流,而不是讲课
- 数据可视化 - 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 抑制剂的教科书内容。首先,请确认:
- 目标读者的水平?(专业人士/研究生/高级)
- 目标篇幅?(默认:8,000 字)
- 是否有特定重点?(机制、临床试验、患者筛选,还是全部?)
您回复期间,我会先在 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]
...