name: submission-toolkit description: > 学术论文投稿工具包。整合 Markdown→Word 格式转换和投稿包组装两项能力。 子命令: /submit convert（Markdown→Word格式转换，支持期刊投稿模式和通用学术模式）、 /submit assemble（投稿包组装：Cover Letter、STROBE清单、盲审检查、声明文件、自检清单）。 触发条件: 用户说"生成Word/转docx/export to word" → convert； 说"准备投稿/组装投稿包/写cover letter/STROBE" → assemble。 domain: 学术管线 triggers:

• /submit convert
• /submit assemble neighbors:
• quality-gate # 上游：审查通过后再组装
• journal-toolkit # 期刊格式要求
• academic-figure-engine # 图表文件
• paper-pipeline # 编排器自动调用 allowed-tools: Read, Write, Edit, Glob, Grep, Bash, WebSearch, WebFetch

Submission Toolkit — 学术论文投稿工具包

边界声明

本 Skill 负责从定稿到可提交投稿包的最后一公里：

与相邻 Skill 的分工:

• quality-gate /qa review：稿件审查在前，本 Skill 在审查通过后执行
• quality-gate /qa integrity：审计报告和 AI 声明由 integrity 生成，本 Skill 纳入投稿包
• journal-toolkit：期刊格式要求和模板由 journal-toolkit 提供，本 Skill 按要求转换

/submit convert — Markdown→Word 格式转换

原 Skill: manuscript-to-word

核心理念

期刊只收 Word，但我们用 Markdown 写作。

触发条件

• 用户说"生成Word文稿"/"转换为docx"/"export to word"
• 用户说"打包投稿"且项目有 scripts/generate_docx.py
• 用户说"学术Word"/"论文模板"/"学术格式"
• /submit assemble 完成后自动触发（pipeline 模式）

模式选择

模式 A: 期刊投稿模式

输出5个文件:

1. {JOURNAL}_manuscript.docx — 主稿（含 Table 1/2 + Figure Legends）
2. {JOURNAL}_title_page.docx — 标题页
3. {JOURNAL}_cover_letter.docx — 投稿信
4. {JOURNAL}_supplementary.docx — 补充材料
5. {JOURNAL}_STROBE_checklist.docx — STROBE 22项清单

期刊排版规范库:

工作流程:

Phase 1: 环境检查 (python-docx/scipy/statsmodels)
Phase 2: 从 manuscript.md 解析生成 docx（单一信源原则）
  - 始终从 manuscript.md 解析，不允许硬编码内容（FP-21 教训）
  - 用 converter.py 模板（已有资源）解析 Markdown 结构
  - 按期刊规范应用样式
  - 已有 generate_docx.py 且含硬编码内容 → 警告并重新从 md 生成
Phase 3: 生成 Word 文件
Phase 4: 质量验证（行号XML/上标引用/表格数量/盲审关键词/字数）
  + Cross-check A: docx 参考文献条数 = manuscript.md 参考文献条数
  + Cross-check B: docx 图注数量 = manuscript.md 图注数量
  + Cross-check C: docx 文件大小校验（含图 >200KB / 纯文字 >30KB）
  + Cross-check D: Python 中文引号已转义（\u201c/\u201d，FP-18）
Phase 5: 打包投稿包 (.zip)

模式 B: 通用学术模式

适用于中文综述、报告、毕业论文。

样式规范: 标题 26pt #17365D 居中、一级标题 14pt #365F91、正文 11pt 首行缩进0.74cm、摘要灰色蒙版 #F1F3F5。

核心代码: _render_rich_text() 解析 ^上标^、**粗体**、*斜体* 标记。

资源引用

• 通用转换器: /Users/terry/.claude/skills/manuscript-to-word/assets/converter.py
• 内容格式规范: /Users/terry/.claude/skills/manuscript-to-word/assets/content_schema.md
• docx生成模板: /Users/terry/.claude/skills/manuscript-to-word/scripts/generate_docx_template.py
• XML模式参考: /Users/terry/.claude/skills/manuscript-to-word/references/xml_patterns.md
• 模板分析文档: /Users/terry/.claude/skills/manuscript-to-word/references/template_analysis.md

常见错误

1. 引用文献段落缺失 → 节边界检测的 skip_tables_section 标志
2. 标题层级跳跃 → ### 应映射 level=2
3. 标题文本重复 → skip_until_next_section = True
4. python-docx 未安装 → pip install python-docx scipy statsmodels pandas numpy

依赖

python-docx, pyyaml, scipy(期刊模式), statsmodels(期刊模式), pandas(期刊模式)

/submit assemble — 投稿包组装

原 Skill: submission-assembler

核心理念

投稿不是写完论文就结束，而是刚走了一半。 STROBE清单、Cover Letter、盲审检查、各种声明、格式转换等全部自动化。

触发条件

• 用户说"准备投稿"/"组装投稿包"/"submission package"/"打包投稿"
• 用户说"写cover letter"/"STROBE清单"/"投稿材料"/"盲审检查"
• quality-gate /qa review 完成后
• paper-pipeline 编排器自动调用

前置门控（启动时自动检查）

/submit assemble 启动 → 前置检查:
  ✅ manuscript_draft.md 存在且非空
  ✅ 数字对账单存在且 ❌=0（Phase 7b 自动生成）
     → 不存在 → 自动触发 /qa check，等待通过
  ✅ /qa integrity 审计报告存在且判定=PASS
     → 不存在 → 自动触发 /qa integrity，等待通过
  ✅ (中文稿件) AIGC 外部检测确认
     → 检测到稿件含中文 → 提醒用户:
        "⚠️ 中文稿件请确认已完成外部 AIGC 检测（PaperPass/知网）
         请回复检测率，或回复'跳过'"
     → 用户回复检测率 → 记录到 submission_checklist
     → 用户回复'跳过' → 记录"AIGC 未外部检测"警告，不阻断

前置全部通过 → 进入 6 个组装模块

输入/输出

• 输入: 定稿(.md) + 目标期刊名称；可选: CLAUDE.md、作者信息
• 输出: submission/ 目录（manuscript_blinded.md、cover_letter.md、strobe_checklist.md、title_page.md、declarations.md、highlights.md、submission_checklist.md）

6个组装模块

Module 1: Cover Letter

• 5段结构: 投稿声明 → 研究问题与重要性 → 核心发现（含数字） → 创新性与适合性 → 合规声明
• 控制在1页(300-400词)
• 禁忌: 不重复摘要全文、不过度吹捧、不攻击其他研究

Module 2: STROBE Checklist

• STROBE 22项自动对照稿件内容
• 找到 → "Yes" + 位置标注；未找到 → "No" + 修复建议

Module 3: Blinding Check

• 扫描作者姓名/机构/城市/IRB编号/基金编号/致谢人名/自引/文件元数据
• 检测到 → 替换为 "[BLINDED]"

Module 4: Declarations

• Data Availability Statement（3种模板按研究类型自动选择）
• Conflict of Interest
• Funding Statement
• Ethics Approval
• Author Contributions (CRediT)
• AI Disclosure

Module 5: Submission Checklist

• 投稿前最终自检清单（稿件/补充材料/必需文件/图表/最终检查）

Module 6: 跨文件一致性检查（阻断门控）

• Check 1: 占位符残留扫描（[[...]]）
• Check 2: 图表引用完整性（每个 Figure/Table 至少被正文引用一次）
• Check 3: Cover Letter 关键数字与主稿比对
• Check 4: 交付物完整性（图片嵌入 + 文件大小校验）
  • manuscript.md 中每个 Figure → 投稿包有对应图片文件
  • docx 文件大小：含图片应 >200KB，纯文字应 >30KB
  • 图片格式：TIF/EPS（高清投稿用）+ PNG（预览用）
• 任何一项不通过 = 阻断，不生成投稿包

期刊特定要求

内置 EJHF（Editorial Manager / 双盲 / STROBE必须 / Novelty statement）和 JACC:HF（ScholarOne / Perspectives statements）的速查信息。

协作关系

quality-gate /qa review  ← 审查稿件
    |
quality-gate /qa integrity ← 审计报告 + AI 声明
    |
/submit assemble ← 组装投稿包
    |
/submit convert ← 全部 .md → .docx
    |
[投稿系统上传]

子命令消歧规则