关于 meta-manuscript-assembly
这项技能用于将系统综述和荟萃分析材料整理成期刊投稿稿件,面向已有分析结果的研究者。它指导制作表格、组图、参考文献和图注,并进行质量检查。
主要功能
- 01制作结果表和补充表
- 02组装多面板图
- 03准备 BibTeX 文献和引文映射
- 04撰写图注
- 05检查投稿材料
适用场景
- 01整理已完成的荟萃分析以投稿期刊
- 02将森林图和漏斗图组合成组图
- 03在合作者审阅前检查表格、图表和参考文献
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ htlin222/ dotfiles --skill meta-manuscript-assembly安装后在 Claude Code 中输入/meta-manuscript-assembly确认已加载。
详细介绍
Meta 分析论文组装
通过创建可直接用于发表的表格、图表和参考文献,完成可提交期刊的系统综述和 Meta 分析论文。
适用场景
- 分析完成后撰写 Meta 分析论文
- 根据 Meta 分析结果创建表格
- 将森林图/漏斗图组装成多面板图
- 为系统综述生成 BibTeX 参考文献
- 按高影响力期刊(Lancet、JAMA、NEJM)的要求排版论文
前置条件
使用此技能前,请确保已准备好:
- 已完成的 Meta 分析及结果表(CSV 格式)
- 已生成的单张图表(300 DPI 的 PNG)
- 已撰写的论文各部分(摘要、引言、方法、结果、讨论)
- 所需引用的完整清单
工作流程
阶段 1:创建表格
根据分析结果创建全面的表格:
正文表格
-
表 1:试验特征
- 从 extraction.csv 或类似文件中提取
- 包含:NCT 编号、第一作者、年份、设计、样本量、干预详情、随访情况
- 以 Markdown 格式排版,并附缩略语说明
-
表 2:疗效结局汇总
- 汇总所有 Meta 分析的结果(pCR、生存结局)
- 包含:效应估计值、95% CI、p 值、I²、绝对获益、NNT
- 添加 GRADE 证据确定性评级
-
表 3:安全性结局汇总
- 根据安全性 Meta 分析结果整理
- 包含:不良事件、发生率、RR/OR、NNH
- 添加临床管理指南
补充表格
-
偏倚风险评估
- 使用 RoB 2 或 ROBINS-I 工具格式
- 对每项试验逐个领域进行评估
- 给出总体风险评级及理由
-
GRADE 证据概况
- 采用结果概要表格式
- 列出所有结局及其证据确定性评级
- 按领域说明具体理由(偏倚、不一致性、间接性、不精确性)
-
详细结果表
- 各试验结果
- 亚组分析
- 敏感性分析
阶段 2:组装图表
创建可直接用于发表的多面板图:
工具:使用 PIL/Pillow 的 Python 脚本
# Create assemble_figures.py
from PIL import Image, ImageDraw, ImageFont
from pathlib import Path
def add_panel_label(img, label, position='top-left', font_size=80, offset=(40, 40)):
"""Add A, B, C labels to panels"""
draw = ImageDraw.Draw(img)
# Try to use system font
try:
font = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", font_size)
except:
font = ImageFont.load_default()
x, y = offset
# Draw white background box for visibility
bbox = draw.textbbox((x, y), label, font=font)
padding = 10
draw.rectangle(
[bbox[0] - padding, bbox[1] - padding,
bbox[2] + padding, bbox[3] + padding],
fill='white',
outline='black',
width=2
)
draw.text((x, y), label, fill='black', font=font)
return img
def create_multi_panel_figure(images_list, output_path, labels=['A', 'B', 'C'], spacing=40):
"""Combine multiple images vertically with labels"""
# Add labels to images
labeled_images = [add_panel_label(img, label) for img, label in zip(images_list, labels)]
# Calculate dimensions
max_width = max(img.width for img in labeled_images)
total_height = sum(img.height for img in labeled_images) + spacing * (len(labeled_images) - 1)
# Create combined image
combined = Image.new('RGB', (max_width, total_height), 'white')
# Paste images
y_offset = 0
for img in labeled_images:
combined.paste(img, (0, y_offset))
y_offset += img.height + spacing
# Save at 300 DPI
combined.save(output_path, dpi=(300, 300))
return output_path
常见图表结构
正文:
- 图 1:多面板疗效图(pCR、EFS、OS 森林图)
- 图 2:亚组分析(例如,按生物标志物状态分组)
- 图 3:安全性和发表偏倚(SAE 森林图、漏斗图)
补充材料:
- 补充图 1:敏感性分析(逐一剔除研究图)
- 补充图 2:发表偏倚(所有结局的漏斗图)
阶段 3:参考文献管理
创建完整的 BibTeX 文件:
步骤:
-
使用 grep 提取论文中的所有引用
grep -E "¹|²|³|⁴|⁵|⁶|⁷|⁸|⁹|⁰|\[\d+\]" manuscript_sections.md -
为每篇参考文献创建 BibTeX 条目
- 所有条目均包含 DOI
- 使用标准化期刊缩写(Index Medicus)
- 正确排版作者姓名
-
创建映射文档
- 将上标(¹、²、³)映射到 BibTeX 键
- 记录论文中的引用位置
-
创建使用指南
- Pandoc 转换说明
- Zotero 导入说明
- 手动排版示例(Lancet、JAMA 样式)
阶段 4:图注
为所有图表撰写完整的图注:
图注结构:
**Panel A. Outcome Name**
Description of what the panel shows. Forest plot showing [effect measure] for [outcome]
across [N] trials ([total participants]). [Statistical method used]. [Key result].
Horizontal lines represent 95% confidence intervals; diamond represents pooled effect.
Vertical line at [null value] indicates no treatment effect.
**Abbreviations**: List all abbreviations used.
包括:
- 统计方法(随机效应、Hartung-Knapp 校正)
- 异质性指标(I²、Cochran's Q)
- 临床解读
- 缩略语释义
阶段 5:质量保证
提交前请核实:
表格
- 所有数据均与分析结果完全一致
- 已定义缩略语
- 脚注解释了所有符号
- 列/行标题清晰
- 统计符号使用一致
图表
- 所有图表分辨率至少为 300 DPI
- 面板标签(A、B、C)清晰可见,且未遮挡数据
- 图注与图表完全一致
- 字号清晰易读(最终印刷尺寸下 ≥8pt)
- 灰度显示时配色仍能清晰区分
参考文献
- 所有引文均有对应的参考文献
- 参考文献编号连续
- DOI 正确且可用
- 期刊缩写格式统一
- 作者姓名与原始出版物一致
输出结构
07_manuscript/
├── tables/
│ ├── Table1_Trial_Characteristics.md
│ ├── Table2_Efficacy_Summary.md
│ ├── Table3_Safety_Summary.md
│ ├── SupplementaryTable1_RiskOfBias.md
│ ├── SupplementaryTable2_GRADE_Profile.md
│ └── ...
├── figures/
│ ├── Figure1_Efficacy.png (300 DPI)
│ ├── Figure2_Subgroup.png (300 DPI)
│ ├── Figure3_Safety.png (300 DPI)
│ ├── SupplementaryFigure1_Sensitivity.png
│ └── ...
├── references.bib
├── FIGURE_LEGENDS.md
├── CITATION_MAPPING.md
└── REFERENCES_USAGE_GUIDE.md
时间估算
- 创建表格:2-3 小时
- 整理图表:1-2 小时
- 参考文献:1-2 小时
- 图例:1 小时
- 质量保证:1 小时
- 总计:6-9 小时
期刊特定格式要求
Lancet Oncology
- 字数限制:4000-5000 字
- 表格:正文最多 3-4 个,补充材料不限
- 图:正文最多 3-4 幅,补充材料不限
- 参考文献:Vancouver 格式,通常为 30-40 条
- 分辨率:至少 300 DPI
JAMA
- 字数限制:3500 字
- 表格:最多 4 个
- 图:最多 4 幅
- 参考文献:最多 40 条
- 分辨率:300-600 DPI
New England Journal of Medicine
- 字数限制:3000 字
- 表格:最多 3 个
- 图:最多 3 幅
- 参考文献:最多 40 条
- 分辨率:至少 300 DPI
应避免的常见问题
- 表格:不要混用效应指标(RR、OR 和 HR)而不清楚标注
- 图:压缩时不要低于 300 DPI
- 参考文献:未经核验,不要使用自动生成的引文
- 图例:不要遗漏统计方法或缩写
- 总体:未经独立核验所有数字,不要提交
相关技能
/meta-analysis- 执行统计分析/prisma-flow- 创建 PRISMA 流程图/grade-assessment- 完成 GRADE 证据概况/risk-of-bias- 使用 RoB 2 工具评估试验质量
调用示例
/meta-manuscript-assembly
或指定阶段:
/meta-manuscript-assembly tables
/meta-manuscript-assembly figures
/meta-manuscript-assembly references
成功标准
- ✅ 所有表格均达到可发表标准,并附有完整说明
- ✅ 所有图均为 300 DPI,并带有专业的面板标签
- ✅ 提供包含全部 30-40 条参考文献的完整 BibTeX 文件
- ✅ 图例完整
- ✅ 所有数字均已对照原始分析核验
- ✅ 手稿符合目标期刊的指南
- ✅ 已准备好供合著者审阅并提交
评论
支持 Markdown