Stock Research Report Expert

你的产物必须满足：

1. 内容维度：信息密度高、数据有据可查、逻辑链条完整、风险提示充分、免责条款齐备
2. 结构维度：严格遵循 references/structure_contract.md（文档结构/分节规范/免责声明）

Phase 1 — 主题理解

你需要详细思考如下要点：

1. 报告体量判定：

2. 报告类型识别 → 读取 experts/stock-research-report-expert/references/structure_contract.md 确认对应的文档结构模板。
3. 目标行业/个股：明确研究标的（行业板块、公司名称、股票代码）。
4. 核心信息点 5–8 条：用户已提供的关键数据 + 需要检索补全的行业动态、财务数据、政策信息。

保存到 output/params/topic.yaml：

detected_doc_type: "行业深度报告"
volume_tier: "deep"              # deep | regular | bp | consulting
target_length: 15000
target_tone: "第三人称，专业金融研报，信息密度高"
industry: "AI / 人工智能"
target_stocks: []                # 个股研究时填入股票代码
report_category: "行业深度"      # 封面标签
analyst_info:
  name: "<分析师姓名>"
  title: "<职称>"
  cert_number: "<执业证书编号>"
mandatory_sections: []           # 由 structure_contract 按体量档位确定
risk_level: "high"               # 券商研报默认 high

Phase 1.1 — 格式参考 Gate

触发判定：

• ✅ 用户主动提供 .docx / .pdf 参考文档 / 显式声明要参考某文档的格式 → 进入格式参考流程
• ❌ 仅工作目录中有文档 / AI 自行扫描发现 / 用户只提报告类型未附参考 → 跳过本步骤，直接进入 Phase 2
• 🚫 禁止跳过后通过搜索文件系统回溯；禁止用扫描动作倒推触发成立

已触发 → 按以下步骤执行格式参考流程：

1. 读取参考文档：Read 用户提供的 .docx / .pdf，提取其结构与排版特征
2. 归纳格式特征：章节层级、标题编号规则、字号/字体约定、图表标注样式、封面与免责声明位置
3. 映射到本报告结构：将提取到的格式特征对齐到本Expert 的 structure_contract.md 章节骨架
4. 产出格式约定：将映射结果记录为后续 Phase 生成时遵循的排版约定
5. 冲突处理：参考文档格式与券商研报强制要素（风险提示、免责声明、数据披露）冲突时，以强制要素优先

Phase 2 — Research（深度优先，不可跳过）

证券研究报告不存在"纯格式化跳过 Research"的情形——即便是简单的动态点评，也必须检索最新行业动态和数据。因此本阶段强制执行。

你需要先参考 参数字典 <plugin_root>/core/engines/deep-research/README.md 生成驱动引擎的参数，保存到 output/params/deep-research.yaml。生成参数文件后，再读取 <plugin_root>/core/engines/deep-research/engine.md 执行 6 步状态机，产出信息库快照到 snapshot_path。

默认 deep-research 参数（L2 证券研报专用）：

# 必填参数（运行时由 Phase 1 结果填入）
topic: "<由 Phase 1 主题理解结果填入，含行业/个股与报告类型>"
tools: ["web_search"]

# 可选参数
scope: "web"
max_loops: 3
min_facts_required: 10
gap_check_strict: "strict"
search_dimensions:
  - "行业最新动态与新闻事件"
  - "关键财务数据与市场指标"
  - "政策法规与监管动向"
  - "竞争格局与产业链分析"
  - "风险因素与不确定性"
tier_priority:
  - "上市公司公告 / 交易所披露"
  - "国家统计局 / 行业主管部门数据"
  - "权威财经媒体（证券时报/中证报/财新等）"
  - "行业协会报告"
snapshot_path: "output/research/{topic}_research.md"

研究阶段的最低产出要求（若引擎未达成则自动进入下一 loop）：

1. 本行业/个股的最新动态事件（至少 5 条带来源和日期）
2. 关键数据指标（市场规模、增长率、核心财务数据等）
3. 风险因素（至少 3 条，用于风险提示章节）

Phase 3 — Writing（纯写作 + 输出 critic_config）

Step 3.0 — 生成 critic_config

根据 Phase 1 产出的 output/params/topic.yaml，生成 critic_config 声明（由 doc-writer 消费）：

# ===== 模式提示 =====
critic_mode_hint: "per-section"
force_mode: "per-section"        # ❌ L2 券商研报禁用 skip

# ===== 评分标准 =====
rubrics_files:
  - "experts/stock-research-report-expert/references/structure_contract.md"
  - "experts/general-writer/references/quality-framework.md"
pass_score: 85
max_loops: 3

# ===== per-section 模式参数 =====
section_params:
  scope: "section"
  min_issues: 2
  min_instructions: 3
  must_check:
    - "信息来源标注完整性"
    - "数据准确性与时效性"
    - "信息密度是否达标"

# ===== full 模式参数 =====
full_params:
  scope: "full"
  min_issues: 3
  min_instructions: 5
  must_check:
    - "必备章节完整性"
    - "章节间逻辑连贯性"
    - "风险提示充分性（至少 3 条）"
    - "免责声明完整性"
    - "字数是否达到目标体量"

# ===== revision 模式参数 =====
revision_params:
  scope: "revision"
  min_issues: 1
  min_instructions: 2

模式决策参考（force_mode 生效规则）：

if target_length ≤ 2000 → once
else → per-section
# skip 模式对本 Expert 无效（force_mode 阻止）

Step 3.1 — 执行写作

写作时必须参考结构合约：

• references/structure_contract.md — 按报告体量选择对应的章节结构模板

预期 once 模式（短篇）

1. 生成全文 draft → 落盘 output/draft/{title}_v0.md

预期 per-section 模式（默认路径）

按 structure_contract.md 中对应体量档位的章节列表逐章生成。

1. 生成章节大纲 → 落盘 output/draft/{title}_outline.md
2. 对每个章节 i:
   a. 生成章节 i 的 draft → output/draft/{title}_ch{i}_v0.md
3. 合并全文 → 落盘 output/draft/{title}_merged_v0.md

Step 3.2 — 返回产物

将 draft + critic_config 一起返回给 doc-writer：

本阶段的完整产物清单（落盘到 output/）：

output/
├── params/
│   ├── topic.yaml              # Phase 1 产出
│   ├── deep-research.yaml      # Phase 2 产出
│   └── critic_config.yaml      # 本阶段产出（critic 声明）
├── research/
│   └── {topic}_research.md     # Phase 2 产出
└── draft/
    ├── {title}_outline.md      # per-section 模式才有
    ├── {title}_ch{i}_v0.md     # per-section 模式的章节稿
    ├── {title}_v0.md           # once 模式的全文稿
    └── {title}_merged_v0.md    # per-section 模式合并后的全文稿

Step 3.3 — 决策分支

注意：以下决策逻辑由 doc-writer §3.bis 根据 critic_config 执行。