用途
meta-manuscript-generator 用于根据用户提供的研究报告生成临床 Meta 分析论文的第一版草稿。输入包括研究报告（需包含完整的方法与结果部分）、语言（中文或英文）以及论文标题，工具将自动生成包含摘要、引言、讨论等部分的完整论文草稿，并自动从 PubMed 检索相关参考文献。该技能适合辅助系统综述与 Meta 分析的写作，提供可复现的工作流程。
主要能力
该技能的工作流分为五个阶段。第一阶段为报告解析，从研究报告中提取方法部分关键词（研究人群、暴露/干预、结局指标、研究方向、主要研究方法）以及结果部分要点（结果解释、文献对比、临床意义、研究局限性）。第二阶段为文献检索，通过 scripts/search_references.py 使用 PubMed 官方 E-utilities API（esearch 获取 PMID 列表，efetch 获取文章详情），按关键词重要性排序，第一关键词返回 15 篇、第二关键词 10 篇、其余各 5 篇，限制为过去 5 年（2020–2025）的出版物。第三阶段为章节写作，依次生成摘要（200–300 词，四段式结构）、引言（300–500 词，不超过 10 篇参考文献）、讨论（模块化顺序：开篇 150–200 词、结果解释≥150 词、文献对比≥150 词、研究局限性 100–150 词、结尾 100–150 词，每个模块引用不超过 10 篇），写作中使用 [PMID: xxxxxxxx] 标记引用。第四阶段为参考文献插入，通过 scripts/insert_references.py 使用 PubMed efetch API 获取格式化引用，解析 XML 生成 AMA 风格参考文献（作者、标题、期刊缩写、年份、卷、期、页码），将 [PMID: xxx] 替换为 [n] 格式，并重新编号。第五阶段为最终整合输出，按标题、摘要、引言、材料与方法（用户提供，原样保留）、结果（用户提供，原样保留）、讨论、结论、参考文献的顺序整合为完整手稿。
使用方式
用户需提供研究报告（包含完整方法与结果部分，以及详细统计数据如 OR、HR、CI、p 值等）、语言和标题。输入格式示例为：Methods and Results: （用户完整内容）、Language: （Chinese/English）、Title: （论文标题）。执行示例：cd "20260316/scientific-skills/Academic Writing/meta-manuscript-generator"，python -m py_compile scripts/insert_references.py，python scripts/insert_references.py --help。依赖 Python 3.10+。第三方包未在此技能包中明确锁定版本。详细写作指南参见 references/writing-guide.md。
适用场景
适用于需要生成临床 Meta 分析论文初稿的学术写作任务，特别是系统综述和 Meta 分析的写作辅助。当需要打包方法而非临时自由输出、期望具体交付物或文件结果、需要通过 scripts/insert_references.py 直接完成请求时使用。
限制
输入验证方面，当请求超出范围、缺少关键输入或需要不支持的假设时，不继续工作流，而是提示用户提供缺失的必需输入或切换到更合适的技能。错误处理方面，如缺少必需输入，需明确说明缺失字段并仅请求最少额外信息；如任务超出范围，停止而非猜测；如执行失败，报告失败点并总结仍可安全完成的部分。不得捏造文件、引用、数据、搜索结果或执行结果。用户提供的方法与结果部分应保留原始措辞，仅做最小格式调整。写作标准要求学术、客观、精确，缩写首次出现时提供全称，保留原始统计数据，避免主观判断、过度解读和冗余陈述。质量检查包括字数是否达标、统计数据是否准确、PMID 是否有效且链接可访问、参考文献是否相关、逻辑是否流畅、参考文献列表是否完整。