Fin Paper Writing

经济金融论文写作编排器

编排从大纲到可投稿论文的全流程，管理章节间的引用一致性和版本迭代。

触发条件

触发关键词：写论文、paper writing、论文写作、开始写作

与 fin-full-pipeline 的关系

fin-full-pipeline 负责"研究"阶段（lit→idea→novelty→design）， 本技能负责"写作"阶段（outline→draft→figure→review→convert）。

Copy code
fin-full-pipeline 终点
       ↓ PAPER_OUTLINE.md + REFINED_DESIGN.md
fin-paper-writing（写作编排）
       ↓
┌──────────────────────────────────────────┐
│ 阶段A: 正文写作 (fin-paper-draft)         │
│   → 生成 draft_v{N}/introduction.tex     │
│       ↓ checkpoint                       │
│ 阶段B: 图表生成 (fin-paper-figure)       │
│   → 生成 draft_v{N}/figures/*.pdf       │
│       ↓ checkpoint                       │
│ 阶段C: 整合检查（章节一致性）              │
│   → 验证引用、表编号、图编号              │
│       ↓ checkpoint                       │
│ 阶段D: 对抗性Review (fin-review-loop)    │
│   → 多轮review直到达标                   │
│       ↓ checkpoint                       │
│ 阶段E: 编译 (fin-paper-convert)          │
│   → 生成 main.pdf                        │
│       ↓                                  │
│ 阶段F: 投稿前检查 (fin-submit-check)      │
│   → SUBMIT_CHECK_REPORT.md              │
└──────────────────────────────────────────┘
       ↓
输出: draft_v{N}/main.pdf（可投稿）

前置条件检查

Phase A: Pre-writing Checklist

在开始写作前，验证以下文件存在：

如果任何文件缺失，停止并提示用户先完成前置步骤。

章节写作顺序（关键原则）

Phase B: Chapter Writing Order

始终使用此顺序，不要按论文的自然顺序写：

Copy code
推荐顺序（而非论文顺序）：
1. Data & Methodology → 先写方法，数据最清晰
2. Descriptive Statistics → 紧跟方法
3. Main Results → 结果最清晰，容易写
4. Mechanism Analysis → 如果有
5. Heterogeneity Analysis → 如果有
6. Robustness Checks → 紧凑汇总
7. Conclusion → 有全篇在手，总结更全面（最难）
8. Introduction → 最后写intro，知道全貌，贡献更清晰
9. Literature Review & Hypotheses → H1/H2/H3框架
10. Abstract → 写完所有章节后，自然形成摘要

为什么这样排序？

• 方法和数据是基础，写完就清楚论文的"做什么"
• 结果是论文核心，先写建立信心
• 结论需要全篇在手，最后写才能全面总结
• 引言需要知道结论，才能准确描述贡献
• 摘要需要知道全文，才能精炼概括

编排协调

Phase C: Orchestration

编排调用以下子技能：

pythonCopy code
# 协调关系图：
fin-paper-writing (编排器)
    │
    ├──→ fin-paper-draft (正文写作)
    │       每个章节独立生成
    │
    ├──→ fin-paper-figure (图表生成)
    │       图表生成后与正文交叉引用
    │
    ├──→ fin-ref-paper (参考文献管理)
    │       确保引用格式一致
    │
    └──→ fin-review-loop (Review循环)
            每章节完成后Review

调用方式（Cursor Skill语法）：

markdownCopy code
<!-- 写方法论章节 -->
Skill: fin-paper-draft
"methodology"

<!-- 生成图表 -->
Skill: fin-paper-figure
"main_results"

<!-- 管理参考文献 -->
Skill: fin-ref-paper
"update"

<!-- Review章节 -->
Skill: fin-review-loop
"methodology_v1"

版本管理

Phase D: Version Management

VERSION_MANIFEST.md

维护版本变更记录：

markdownCopy code
# 版本清单

**论文标题**: [标题]
**目标期刊**: [期刊]
**当前版本**: draft_v{N}

## 版本历史

| 版本 | 日期 | 主要变更 | 作者 |
|------|------|---------|------|
| draft_v1 | 2026-06-13 | 初始草稿 | Agent |
| draft_v2 | 2026-06-14 | 补充机制检验 | Agent |
| draft_v3 | 2026-06-15 | 根据Review修改引言 | Human |

## 当前状态

| 章节 | 状态 | 字数 | 最后修改 |
|------|------|------|---------|
| introduction.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 1,234 | 2026-06-13 |
| literature.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 2,345 | 2026-06-13 |
| methodology.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 1,567 | 2026-06-12 |
| results.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 3,210 | 2026-06-12 |
| robustness.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 890 | 2026-06-13 |
| conclusion.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 678 | 2026-06-13 |
| abstract.tex | [DRAFT/REVIEWING/REVISED/FINAL] | 250 | 2026-06-13 |
| references.bib | [DRAFT/REVIEWING/REVISED/FINAL] | — | 2026-06-13 |

CHAPTER_STATUS.md

追踪每个章节的详细状态：

markdownCopy code
# 章节状态追踪

## 章节详情

### introduction.tex
- **状态**: DRAFT
- **字数**: 1,234
- **创建时间**: 2026-06-13 10:00
- **最后修改**: 2026-06-13 14:30
- **Review轮次**: 0
- **检查清单**: 
  - [x] 动机充分
  - [x] 3个贡献点清晰
  - [ ] 字数符合期刊要求
  - [x] Roadmap包含
- **备注**: 需补充第3个贡献点

### methodology.tex
- **状态**: REVIEWING
- **字数**: 1,567
- **Review轮次**: 1
- **Review反馈**: 通过

版本迭代流程

当需要重大修改时：

markdownCopy code
## 创建新版本流程

1. 将 draft_v{N}/ 复制为 draft_v{N+1}/
2. 在 VERSION_MANIFEST.md 中记录：
   | draft_v{N+1} | [日期] | [修改原因] | Agent/User |
3. 在 CHAPTER_STATUS.md 中标记需修改的章节为"重写"
4. 执行修改
5. 重新执行 阶段C（一致性检查）→ 阶段D（Review）→ 阶段E（编译）→ 阶段F（检查）

一致性检查

Phase E: Consistency Checks

每章节完成后，自动执行以下检查：

检查1：图表编号一致性

检查2：表格编号一致性

检查3：假设与结果一致性

检查4：引用一致性

• 所有 \cite{} 都在 references.bib 中存在
• 引用格式统一（JF风格/GB-T-7714）
• 无"幽灵引用"（引用但无对应条目）

检查5：文字质量检查（新增）

每章节完成后，必须执行以下 AI 味和底气检测：

AI 味检测清单（扫描到任一关键词即为不合格）：

扫描关键词（中文）：值得注意的是 | 综上所述 | 从某种意义上 | 客观来说 | 在一定程度上 | 某种程度上 | 相对而言 | 近年来 | 随着时代发展 | 当今社会 | 可能存在 | 有待进一步研究 | 首先我们需要 | 非常重要的 | 具有重大意义的 | 已经被 | 可以被认为 | XX研究表明

底气指数评估（结论段必须满足≥1项）：

表格引导句检查：每张表格前是否有≥2句引导（主题句 + 来源句 + 核心发现句），每张表格后是否有≥1句解读。

图表注释解读检查：每个图表的 caption/注释是否包含"说明什么"（而不仅是"展示什么"），是否包含具体数字或对比描述。

语言质量检查不通过的章节，不得进入 Review 环节，必须先重写。

语言质量标准（新增）

T07：语言质量 Review 环节

在 Phase C（Orchestration）中，每章节写作完成后，必须触发语言质量 Review：

markdownCopy code
<!-- 每章节完成后执行 -->
Skill: fin-paper-draft
"language_check"

语言质量 Review 标准：

T08：CHAPTER_STATUS.md 语言质量字段

更新 CHAPTER_STATUS.md 模板，增加语言质量追踪字段：

markdownCopy code
### introduction.tex
- **状态**: DRAFT
- **字数**: 1,234
- **语言质量检查**:
  - [ ] AI 味关键词: 0次（要求 ≤ 0）
  - [ ] 底气指数: 结论段含具体数字（是/否）
  - [ ] 表格引导句: 每表前后 ≥ 3句（是/否）
  - [ ] 图表注释: 每图 ≥ 1句解读（是/否）

VERSION_MANIFEST.md 新增语言质量维度

版本记录中新增语言质量维度：

markdownCopy code
| 版本 | 日期 | 主要变更 | 语言质量 | 作者 |
|------|------|---------|---------|------|
| draft_v1 | 2026-06-13 | 初始草稿 | AI味0/底气足 | Agent |

输出文件结构

Copy code
output/fin-manuscript/draft_v{N}/
├── introduction.tex      # 引言
├── literature.tex         # 文献综述与假说
├── methodology.tex        # 数据与实证方法
├── results.tex            # 实证结果
├── robustness.tex         # 稳健性检验
├── conclusion.tex         # 结论
├── abstract.tex           # 摘要
├── references.bib         # 参考文献
├── tables/                # 表格文件
│   ├── tab1_var_def.tex
│   ├── tab2_summary.tex
│   └── ...
├── figures/               # 图表文件
│   ├── fig1_sample.pdf
│   ├── fig2_trend.pdf
│   └── ...
├── VERSION_MANIFEST.md    # 版本清单
├── CHAPTER_STATUS.md      # 章节状态
├── CONSISTENCY_CHECK.md   # 一致性检查报告
└── main.pdf              # 编译后的PDF

Checkpoint（检查点）

每个Phase完成后必须暂停，等待用户确认：

Review重点（按章节）

控制标志

关键原则

1. 方法论先写。先写methodology和results，有助于理清思路，避免intro空洞。
2. 章节独立追踪。每个章节有自己的状态、字数、最后修改时间。
3. 一致性是底线。图表编号、表编号、公式编号必须在正文和计划文件中完全一致。
4. Review在整合后。等图表和正文都写完再做Review，避免重复Review。
5. 版本是审计记录。每次重大修改都要记录变更原因和审查意见采纳情况。
6. 中文论文写作顺序略有不同。中文期刊常按顺序写（引言→文献→方法→结果→结论）。
7. 写作过程要记录。在VERSION_MANIFEST.md中实时更新状态。
8. 终稿前必须通过submit-check。格式和匿名性是编辑初审的门槛。
9. 占位符规则。首次生成用[coef]、[se]、[N]占位，由数据填充。
10. 每次保存后自动更新状态。章节完成、修改、保存后立即更新CHAPTER_STATUS.md。