| name | quant-paper-analysis |
| description | 对资产定价、金融工程、固定收益、衍生品、公司金融与数量金融论文执行结构化中文深度分析与总结，输出分模块 Markdown 子文档并自动合并清理为总报告。当用户要求“深度剖析论文、按研究背景/文献定位/方法/发现/贡献写报告、补充数学推导与经济直觉、分块保存并脚本合并排版”时使用。 |
Quant Paper Analysis
Overview
执行可复用的量化金融文献分析工作流，产出学术风格统一的中文报告。
适用于理论、实证、校准或混合研究，不局限于信用风险主题。
Inputs
开始前确认以下输入：
- 目标论文 Markdown 路径（通常位于
PaperFolder/）。
- 输出目录（默认
PaperFolder/notes_zh）。
- 是否采用“正文保留核心命题，详细证明放附录”的组织方式（默认是）。
Workflow
按以下顺序执行，不跳步。
Step 1: 读取与抽取
- 通读目标论文，提取：研究问题、理论框架、识别策略、关键公式、命题/定理/引理、主要结论。
- 建立“数学命题 -> 经济机制 -> 可检验含义”的映射。
- 若原文含附录证明，先复核逻辑链条，再进行中文重构。
Step 2: 分块写作
- 在
notes_zh 生成模块化子文档，默认顺序参考 references/module_order.md。
- 每个子文档目标 75-200 行；允许区间 50-400 行。
- 正文模块必须覆盖：
- 研究背景与意义
- 文献回顾与定位
- 研究方法
- 研究发现
- 研究贡献
- 数学组织规则：正文保留核心命题与关键结论；长推导放入附录。
- 标题规则（关键）：
- 每个子文档首个标题仅写“该章节名称”，不得重复论文总标题。
- 子文档使用合并安全的标题层级：模块标题用
##，子节用 ###。
- 避免在子文档内使用
# 一级标题。
- 术语与表达规则：
- 使用第三人称、客观书面语。
- 核心术语首次出现写“中文（English）”，后文统一。
- 公式使用可渲染 LaTeX：行内
$...$，块级 $$...$$。
Step 3: 合并与排版
- 将技能内脚本
scripts/merge_notes.py 复制到论文目录 scripts/ 后执行。
- 脚本按编号顺序合并
notes_zh 子文档，并自动清理：
- 冗余来源标记（如“来源文件：xx.md”）
- 重复论文总标题块（跨不同论文命名形式）
- 句中异常换行导致的段落断裂
- 子文档误用的
# 标题层级（自动规范到 ##）
- 输出总报告到
notes_zh，默认文件名：<PaperKey>_完整分析报告.md。
Step 4: 质检
全部通过后再交付：
- 结构完整：五大正文模块 + 附录证明模块。
- 术语一致：符号、参数命名与术语翻译一致。
- 公式正确：
$ 与 $$ 成对闭合。
- 排版干净：无断句换行、无重复论文大标题、无冗余来源行。
- 工程完整：已运行合并脚本，最终总报告存在且可读。
Output Contract
交付结果必须包含：
notes_zh/*.md 子文档（按编号顺序）。scripts/merge_notes.py（论文目录内，可重复执行）。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 并自动命名输出文件。
