ivr-chapter-earnings

name	ivr-chapter-earnings
description	撰写投价报告「盈利预测」章节（分业务收入预测/量价拆分/毛利率/费用率/完整财务预测表）。当用户要求写投价报告盈利预测、营收拆分、量价拆分、毛利率预测、费用率预测、财务预测汇总时触发。

投价报告：盈利预测

本 skill 撰写投价报告「盈利预测」章节。 共享基座规范（模型只读、输出铁律、样本使用、原创性检查、工具说明）由 ivr-base 定义。

---

1. 输入

输入	来源	说明
<模型.xlsx>	session_variables.financial_model_path	投价报告体系标准财务模型，必选
<语料目录>	用户上传	招股书/问询函/落实函等 PDF，可选

获取财务模型路径：从 session_variables.financial_model_path 读取。 若该变量为空，提示用户先通过 ivr_upload_financial_model 工具注册财务模型文件。

---

2. 工作流

2.1 引擎准备（确定性数据）

python scripts/build_earnings.py {financial_model_path} _out

其中 {financial_model_path} 从 session_variables.financial_model_path 获取。

引擎产出：

• _out/盈利预测_骨架.md — 表格/数字/工作单/自检（不写依据和判断性叙述）
• _out/盈利预测_工作单.json — 结构化工作单（业务线/占比/详略档/驱动行/自检）

2.2 表格生成（数据驱动）

python scripts/gen_tables.py {financial_model_path} _out

引擎产出：

• _out/tables_gen.md — 全部表格的 Markdown（按 <<TBL:key>> 命名）
• _out/table_keys.json — 表格 key 到业务线的映射表

表格 key 命名规则：

• driver_<slug> — 各业务线的量价驱动表（slug 从业务线名自动生成）
• gross_margin — 毛利率预测表
• expense_ratio — 费用率预测表
• full_forecast — 完整财务预测表
• risk_adj — 经风险调整收入表（如有风险因子 sheet）
• legacy — 原有业务表（如有）

2.3 AI 写正文

按下方铁律，逐工作单写正文。每个板块/业务线：

1. 先定官方口径：从招股书“主营业务/产品介绍”章节抄录产品大类及下属产品，形成官方口径对照表。
2. 读引擎表格：从系统注入的 <engine_tables> 块中读取对应表格（引擎已按 H3F3 生成）。
3. 用 ivr_search_rag 检索招股书/问询函原文作为假设依据。
4. 写「定义 + 占比 → 量 → 价 → 小结」的完整叙述。
5. 直接复制引擎表格到正文中（不得修改表格内容）。
6. 语料缺失的依据进入 _out/盈利预测_待补底稿.md，不进正文。

2.4 输出

• _out/盈利预测_报告.md — 干净正文（可直接挂网）
• _out/盈利预测_待补底稿.md — 待补清单（不进报告）

---

3. 章节结构（固定编号，必须严格遵循）

章节结构必须与 skill.schema.yaml 一致，OutputValidator 会严格校验。

## 2. 盈利预测

### 2.1 分业务收入预测（量价拆分）
  - 按招股书官方口径分板块；每个板块用 2.1.x 四级标题
  - 每个板块：定义+历史占比 → 量 → 价 → 小结句 → 量价表

### 2.2 毛利率预测
  - 综合毛利率趋势
  - 分板块/关键产品毛利率逻辑
  - 毛利率表

### 2.3 费用预测
  - 销售/管理/研发/财务/税金等费用率
  - 费用率表

### 2.4 盈利预测汇总（完整财务预测表）
  - 固定句式结论
  - 完整利润表预测

不新增 2.5、2.6；不把敏感性或估值内容写入本章。

---

4. 盈利预测铁律

4.1 报告可直接挂网

• 正文必须专业、通顺、终稿级。
• 严禁出现任何 【待确认】/【待资料确认】/【依据待补】/“暂无公开数据支撑”等过程性标注。
• 以模型数据为既定事实正常成稿；缺依据只进待补底稿。
• 禁用“模型预测/模型假设”，用“我们预计/我们认为/我们判断”。

4.2 收入拆分口径：先定义后预测

分产品/分类别做营收预测前，必须先以招股书官方口径确定“每个类别包含哪些产品”。

强制流程：

1. 打开招股书“主营业务/产品介绍”章节，抄录各产品大类及下属产品清单。
2. 每个板块的第一句必须是“定义 + 范围 + 历史营收占比”。
3. 把报告里每个产品名回查其在招股书中的归属，发现不一致立即改。

4.3 量价拆分粒度

• 顶层大类必拆：模型收入拆分的每个顶层大类，原则上对应 2.1.x 一个小节。
• 大类内产品按驱动逻辑判断：
  • 量是否共享同一增长逻辑？
  • 价是否共享同一定价逻辑？
• 都“是” → 可以合并叙述，但表格仍逐产品逐行列示。
• 任一“否” → 逐产品/产品线拆开写各自驱动链。
• 合并只限同一大类节内，不能跨大类合并。

4.4 量价依据：三要素 + 量价错开呈现

销量/单价/增速论证不能只报数值，必须覆盖三个要素：

1. 行业整体趋势：行业规模、增速、周期、国产化率、渗透率等。
2. 公司产品地位：客户、技术、份额、认证、产品矩阵等。
3. 核心增长驱动：订单、募投、产品升级、新品放量、国产替代、价格结构变化等。

呈现方式：

• 量的论证可用分点式（行业趋势/公司地位/核心驱动）。
• 价的论证改用叙述式，把三要素融入一段话，避免和量段套同一模板。

4.5 表格规则：H3F3 + 逐行

• 所有“含历史 + 预测”的盈利预测表统一为历史 3 年 + 预测 3 年。
• 适用：收入量价驱动表、经风险调整收入表、毛利率表、费用率表、完整财务预测表。
• 估值章 DCF/FCFF 现金流表不属于本章，由 ivr-chapter-valuation 处理。
• 收入预测部分的表格一律不写毛利率行；毛利率单独在 2.2 成节成表。
• 每个指标单独占一行，禁止把“收入｜销量｜单价”挤进同一格。
• 凡正文单独分析过的产品/品类，都必须在表里逐行列出；存在量价关系的，应列收入、销量、单价/ASP。
• 分产品收入加总应能核对到板块汇总。

4.6 表格随文

• 先讲假设与逻辑，再放表格。
• 每个重要盈利预测元素的总述/假设文字下方紧跟对应表格。
• 表格必须从 <engine_tables> 直接复制，不得自行编造或修改内容。
• 如果 <engine_tables> 没有对应表格，写入待补底稿，不得在正文留下“引擎未生成”之类标注。

4.7 不写“整体”小标题

细分项讲完后的板块小结，直接在该板块量价表下方用正文承接，例如：

综合上述分析，我们预计 2026—2028 年半导体关键工艺零部件收入分别为……

不要单列“（N）××整体”这种标题。

4.8 管线/biotech 型公司专项

若模型含 风险因子 sheet：

1. 必须呈现风险调整框架：未/经风险调整收入、各管线假设成功率。
2. 保留模型的占比口径标签，如“HY1001 全适应症 = 肝硬化低白 + 其他适应症”。
3. 诊疗指南、集采价、发病率、临床成功率文献等依据，语料命中则用原创措辞引述；命不中进入待补底稿。

---

5. 数据来源与检索规范

5.1 数据来源区分（强制）

数据类型	来源	AI 处理方式
预测数字（收入/毛利率/费用率/利润）	模型 / <engine_tables>	直接引用，不从 RAG 检索
历史数字（历史收入/毛利率/费用率）	模型 / <engine_tables>	直接引用，不从 RAG 检索
表格数据（量价驱动表/毛利率表/费用率表）	模型 / <engine_tables>	直接复制，不修改
官方产品口径	招股书/招股意向书	写收入拆分前先核对
假设依据（为什么取这个值）	招股书/问询函/落实函等语料	用 ivr_search_rag 检索，原创转述
行业数据（市场规模/渗透率/竞争格局）	用户语料	用 ivr_search_rag 检索

⛔ 禁止从 RAG 检索预测数字：预测收入、毛利率、费用率等数字必须来自模型。

5.2 写作流程（强制）

1. 建官方口径对照表。
2. 读取 <engine_tables> 中的 H3F3 表格。
3. 对关键假设检索语料依据。
4. 写专业正文，不暴露模型过程。
5. 复制引擎表格。
6. 将缺来源项写入 _out/盈利预测_待补底稿.md。
7. 成稿前按 ivr-base 要求做原创性检查。

5.3 RAG 检索词表（仅用于检索“依据”）

检索场景	建议关键词	用途
官方产品口径	主营业务、产品介绍、主要产品、业务构成	建板块/产品归属表
行业趋势	市场规模、增长率、行业空间、国产化率、周期	解释销量/收入增速
公司地位	核心客户、技术水平、市场份额、认证、竞争格局	解释公司能否兑现增长
核心驱动	在手订单、募投项目、产能规划、新品、客户导入	支撑放量或价格假设
单价依据	产品结构、定价策略、竞品价格、历史单价	解释 ASP 变化
毛利率波动	成本变化、产品结构、规模效应、产能利用率	写毛利率逻辑
费用率依据	销售费用、管理费用、研发投入、财务费用、对标公司	写费用率逻辑

---

6. 引擎脚本说明

scripts/build_earnings.py

盈利预测引擎，产出工作单/驱动表/骨架/自检：

1. reader 把「收入拆分」解析成每业务线一张工作单。
2. 每条线算收入占比 → 定详略档（核心/次要）。
3. 判型（量价型/增长率型）。
4. 量价型做“能否乘回收入”自检。

scripts/gen_tables.py

数据驱动的表格生成器：

1. 从模型动态检测年份区间和列布局。
2. 所有含历史 + 预测的盈利预测表统一生成 H3F3。
3. 自动为每条业务线生成驱动表，不硬编码管线名。
4. 毛利率/费用率/汇总表从模型生成。

---

7. 自检清单

写作完成后，AI 需自检：

• 章节结构为 2.1—2.4，无 2.5/2.6。
• 收入拆分口径已按招股书官方产品分类核对。
• 每个板块先定义范围和历史占比，再预测。
• 量价依据覆盖行业趋势、公司地位、核心驱动。
• 量段和价段呈现方式不同，不机械套模板。
• 所有预测数字来自 <engine_tables>，不是来自 RAG。
• 表格直接复制自 <engine_tables>，且均为 H3F3。
• 收入表不含毛利率行，毛利率单独成节。
• 正文分析过的产品/品类均进入表格。
• 无过程性标注。
• 缺来源项已进入 _out/盈利预测_待补底稿.md。
• 已按 ivr-base 要求进行原创性检查。