quant-paper-analysis

name	quant-paper-analysis
description	对资产定价、金融工程、固定收益、衍生品、公司金融与数量金融论文执行结构化中文深度分析与总结，输出分模块 Markdown 子文档并自动合并清理为总报告。当用户要求“深度剖析论文、按研究背景/文献定位/方法/发现/贡献写报告、补充数学推导与经济直觉、分块保存并脚本合并排版”时使用。

Quant Paper Analysis

Overview

执行可复用的量化金融文献分析工作流，产出学术风格统一的中文报告。 适用于理论、实证、校准或混合研究，不局限于信用风险主题。

Inputs

开始前确认以下输入：

1. 目标论文 Markdown 路径（通常位于 PaperFolder/）。
2. 输出目录（默认 PaperFolder/notes_zh）。
3. 是否采用“正文保留核心命题，详细证明放附录”的组织方式（默认是）。

Workflow

按以下顺序执行，不跳步。

Step 1: 读取与抽取

1. 通读目标论文，提取：研究问题、理论框架、识别策略、关键公式、命题/定理/引理、主要结论。
2. 建立“数学命题 -> 经济机制 -> 可检验含义”的映射。
3. 若原文含附录证明，先复核逻辑链条，再进行中文重构。

Step 2: 分块写作

1. 在 notes_zh 生成模块化子文档，默认顺序参考 references/module_order.md。
2. 每个子文档目标 75-200 行；允许区间 50-400 行。
3. 正文模块必须覆盖：
   • 研究背景与意义
   • 文献回顾与定位
   • 研究方法
   • 研究发现
   • 研究贡献
4. 数学组织规则：正文保留核心命题与关键结论；长推导放入附录。
5. 标题规则（关键）：
   • 每个子文档首个标题仅写“该章节名称”，不得重复论文总标题。
   • 子文档使用合并安全的标题层级：模块标题用 ##，子节用 ###。
   • 避免在子文档内使用 # 一级标题。
6. 术语与表达规则：
   • 使用第三人称、客观书面语。
   • 核心术语首次出现写“中文（English）”，后文统一。
   • 公式使用可渲染 LaTeX：行内 $...$，块级 $$...$$。

Step 3: 合并与排版

1. 将技能内脚本 scripts/merge_notes.py 复制到论文目录 scripts/ 后执行。
2. 脚本按编号顺序合并 notes_zh 子文档，并自动清理：
   • 冗余来源标记（如“来源文件：xx.md”）
   • 重复论文总标题块（跨不同论文命名形式）
   • 句中异常换行导致的段落断裂
   • 子文档误用的 # 标题层级（自动规范到 ##）
3. 输出总报告到 notes_zh，默认文件名：<PaperKey>_完整分析报告.md。

Step 4: 质检

全部通过后再交付：

1. 结构完整：五大正文模块 + 附录证明模块。
2. 术语一致：符号、参数命名与术语翻译一致。
3. 公式正确：$ 与 $$ 成对闭合。
4. 排版干净：无断句换行、无重复论文大标题、无冗余来源行。
5. 工程完整：已运行合并脚本，最终总报告存在且可读。

Output Contract

交付结果必须包含：

1. notes_zh/*.md 子文档（按编号顺序）。
2. scripts/merge_notes.py（论文目录内，可重复执行）。
3. notes_zh/<PaperKey>_完整分析报告.md（最终报告）。

Resources

按需读取：

• 模块顺序与命名：references/module_order.md
• 写作与数学规范：references/style_and_math.md
• 质检清单：references/qa_checklist.md
• 合并脚本：scripts/merge_notes.py
• 报告头模板：assets/report_header_template.md

Command Snippets

在论文目录执行：

python scripts/merge_notes.py --notes-dir notes_zh --output notes_zh/HE2012_完整分析报告.md

不传参数时，脚本默认使用 notes_zh 并自动命名输出文件。