academic-review-workflow

name	academic-review-workflow
description	从可复用模板创建并执行结构化学术综述 / 课程报告项目。适用于需要搭建文献综述工作区、把 README 要求转化为写作计划、协调 academic-paper-strategist 与 academic-paper-composer、落实证据库与引用规则，或在交付前检查引用频次、图表引用、主题一致性、摘要贴合度和审稿式质量控制时。

学术综述写作工作流

将本 skill 作为学术综述项目的总控层使用。

核心流程

1. 创建项目目录。

   • 写作前先选择模板：
     • assets/project-template：用于 CJME / 中文期刊风格论文。
     • assets/project-template-ieee：用于 IEEE 风格单栏课程报告；该模板要求每个一级章节单独起页。
   • examples/ 只作为已完成成品参考，不作为干净起点。
   • 保持统一目录结构：docs/、docs/sections/、refs/papers/、refs/notes/、refs/bib/、assets/。

2. 写作前先阅读并更新 README.md。

   • 将 写作内容 视为主题、内容范围、文章结构、页数和字数的唯一依据；其余部分视为引用、图片、格式和交付约束的唯一依据。
   • 在开始实质性写作前，替换所有占位内容。

3. 先规划，再动笔。

   • 先使用 academic-paper-strategist 完成选题确认、检索策略、研究缺口分析、文献筛选和提纲设计。
   • 在主题、提纲和证据库尚未统一之前，不要开始写正文。
   • 除非任务另有要求，优先采用适合综述论文的主线：问题界定 -> 基础概念 -> 方法谱系 -> 比较与综合 -> 应用或融合趋势 -> 当前问题 -> 结论。

4. 先建立证据库，再起草。

   • 若 refs/papers/ 为空，立即停止后续写作并先下载论文；不能在证据库为空的情况下开始正文。
   • 全文默认引用总量约 42 篇，除非项目 README 另有要求；这不等于必须把 42 篇论文都下载到 refs/papers/。
   • refs/papers/ 中至少保留 10 篇相关领域顶会或顶刊论文，作为可核查的核心证据库，确保综述建立在高质量文献之上，而不是只依赖边缘来源。
   • 文献集应尽量全部控制在近 5 年，中英文比例约为 3:7。
   • 维护 refs/notes/paper_index.md 作为本地核心 PDF 证据库账本，只登记下载到 refs/papers/ 的核心论文。全文引用全集由 refs/bib/references.bib 管理。
   • paper_index.md 只保留必要字段：Key、角色、拟用于章节、PDF。年份、期刊、题名等信息交给 BibTeX 管理，避免重复维护。
   • 在起草前为每篇论文分配论证角色，如：基础、方法谱系、比较、应用、趋势、图源或局限。高质量综述应按“论证角色”组织，而不是简单堆叠论文。
   • refs/bib/references.bib 中只允许放入真实来源。
   • 放入 refs/papers/ 的核心论文都必须在正文中被引用；本地证据库应保持精炼，不必机械下载全文所引全部文献。

5. 按顺序起草。

   • 使用 academic-paper-composer 基于已确认提纲写作。
   • 标题层级统一使用 1. / 1.1 / 1.1.1。
   • 标题、图题、表题都应尽量精简，能单行就不要无谓换成两行。
   • 对 IEEE 风格课程报告，保留“每个一级章节单独起页”的模板规则。
   • “总结与展望”或“结论”采用总—分—总结构；中间的 （1） / （2） / （3） 必须各自独立成段，不能压成一整块。
   • 每个标题下的内容都要充实，避免只有一两句的薄弱段落；每节都应有清晰论点、必要展开和自然过渡，使全文内容充分、逻辑清楚、层次分明。
   • 综述段落要写成“综合”，不要写成逐篇文献摘要串联。每个重要小节通常应完成四件事：提出组织问题、解释核心机制、比较代表性路线或取舍、落到工程意义或未解问题。
   • 每张图和每个表之后，都应有解释段，说明它展示了什么、为何支撑当前论证；不要让图表沦为装饰。
   • 当主题天然包含多类方法、流程、模型或设计路线时，至少使用 1 张比较表。
   • 引言应按照“领域问题 -> 传统方法局限 -> 本文聚焦方法为何重要 -> 本文覆盖范围”的顺序展开。
   • 初次成稿时，若主题适合，正文优先加入约 3–5 个数学公式。每个公式都必须来自教材或论文，并保留明确来源；不得为了凑数虚构装饰性公式。
   • 初稿阶段先保留图位；提醒作者后续从参考论文中截取合适图片放入 assets/。

6. 以审稿人视角修订，而不是只做文字校对。

   • 删除“从课程内容看”“课程要求表明”等课程化表达。
   • 检查主题一致性、论证连续性、章节均衡、段落是否充实、语言清晰度、摘要与正文的一致性，以及无效内容。
   • 修订过长标题、图题和表题；保留原意，但去掉会造成无谓换行或视觉杂讯的冗余措辞。
   • 检查全文是否只是“文献罗列”，还是已经形成真正的综述判断：方法边界、优势、劣势、适用场景、瓶颈和未来方向都应明确出现。
   • 检查最终摘要是否真实映射正文主线：范围、覆盖方法、应用场景和结论判断应与正文一致，而不是停留在泛泛背景介绍。
   • 中文表达需要润色时，在实质性修订之后使用 humanizer-zh，并保留内容密度、逻辑清晰度和层次结构。
   • 若论文偏技术 / CS 方向，同时使用 academic-research-writing。

7. 宣布完成前，运行确定性检查。

   • 使用 scripts/check_review_project.py <project_root>。
   • 该脚本只负责机械检查；若发现问题，先修复，再重复运行直到通过。

交付前必须检查

• refs/papers/ 中的核心论文都已登记到 refs/notes/paper_index.md，并已在正文中引用；全文所有引用都已进入 refs/bib/references.bib。
• 起草前 refs/papers/ 不为空，且证据库中至少包含 10 篇相关领域顶会或顶刊论文。此项需人工确认。
• 每篇文献都满足 README.md 中的引用频次规则。
• 除非 README 另有要求，全文参考文献总数约为 42 篇。
• 文献整体控制在近 5 年，中英文比例约为 3:7。此项需人工确认。
• 每个图标签只被定义 1 次、引用 1 次；每个图引用都能解析到真实图标签。
• 标题、图题、表题足够精简，在最终版式中尽量避免无必要的两行换行。此项需在编译后人工查看。
• 若主题适合公式，首版完整初稿应包含约 3–5 个可追溯到教材或论文的数学公式，而不是临时虚构的公式。此项需人工确认。
• 对 IEEE 风格课程报告，每个一级章节都应另起一页。此项需在编译后人工确认。
• “总结与展望”或“结论”采用总—分—总结构，且 （1） / （2） / （3） 分别独立成段。此项需人工确认。
• 每个标题下的段落都已充分展开，而不是敷衍性短段；全文逻辑清楚、论证层次明确。此项需人工确认。
• 引言具备从问题到缺口再到综述范围的漏斗结构；正文读起来是综合评述，而不是逐篇文献目录。此项需人工确认。
• 每个重要图表都在附近正文中得到解释；当主题存在多种方法路线时，至少使用 1 张比较表。此项需人工确认。
• 全文已经明确给出综述级判断：比较优势、局限、适用范围和开放问题都能被读者直接看到，而不是只能自行猜测。此项需人工确认。
• 摘要、标题、关键词和正文都围绕同一主题。
• 可复用模板中不得残留个人信息。

验证

• 交付前运行 scripts/check_review_project.py <project_root>。
• 该脚本检查：引用频次、BibTeX 条目、核心 PDF 索引覆盖、本地 PDF 链接、最小引用数量以及图引用机制。