Doubao Finance Model Builder

Doubao Finance Model Builder

强制读取完整性协议

不得假设一次工具调用能够完整返回 SKILL.md 或引用文件。先读取 references/reading-manifest.json，再按所选工作流确定必读文件，并对每个必读文件执行以下步骤：

1. 先取得文件总行数；工具不能直接返回总行数时，继续分段读取直至文件末尾。
2. 按不重叠的连续区间读取，默认每段最多 100 行，例如 1—100、101—200、201—300。不得重复读取首段来代替续读，不得跳过中间区间。
3. 每个 Markdown 文件末尾必须包含唯一标记 <!-- END OF FILE: 文件名 -->。只有最后一段明确包含与当前文件名一致的标记，才可将该文件记为 READ_COMPLETE。
4. 建立 reading-ledger.json，逐文件记录 path、total_lines、chunks_read、end_marker_found 和 status。区间必须从第 1 行连续覆盖至 total_lines，否则状态为 INCOMPLETE。
5. 所有必读文件均为 READ_COMPLETE 后，才能创建执行计划、检索数据、运行脚本或开始建模。工具不支持行号、offset 或分页，或无法确认文件末尾时，停止并报告读取阻断；不得凭部分内容继续。
6. 组合任务取各工作流必读集合的并集，只读取一次并在台账中复用完成状态。条件性资料仅在适用时加入必读集合。

任务涉及 Excel、.xlsx、Sheet、电子表格或公式工作簿时，必须将外部 sheet/SKILL.md 加入必读集合；金融或财务场景同时将 sheet/references/ref-financial-modeling-standards 加入必读集合。对两者按同样的分段和连续覆盖规则完整读取；外部文件有末尾标记时记录 end_marker_found=true，没有末尾标记时必须通过工具确认已达EOF并记录 eof_confirmed=true。在 reading-ledger.json 中以 external_skills 记录实际解析路径、必读引用与状态。二者均为 READ_COMPLETE 后才能创建执行计划、运行工作簿生成脚本或开始建模；未安装、无法定位或未完整读取时停止并报告读取阻断，不得凭本 skill 内容推测外部规范。

reading-ledger.json 的最小结构：

{
  "chunk_lines": 100,
  "files": [
    {
      "path": "references/model-and-artifact-controls.md",
      "total_lines": 107,
      "chunks_read": [[1, 100], [101, 107]],
      "end_marker_found": true,
      "status": "READ_COMPLETE"
    }
  ],
  "external_skills": [
    {
      "name": "sheet",
      "path": "SKILL.md",
      "resolved_path": "/actual/installed/path/sheet/SKILL.md",
      "total_lines": 150,
      "chunks_read": [[1, 100], [101, 150]],
      "end_marker_found": false,
      "eof_confirmed": true,
      "status": "READ_COMPLETE"
    },
    {
      "name": "sheet",
      "path": "references/ref-financial-modeling-standards",
      "resolved_path": "/actual/installed/path/sheet/references/ref-financial-modeling-standards",
      "total_lines": 120,
      "chunks_read": [[1, 100], [101, 120]],
      "end_marker_found": false,
      "eof_confirmed": true,
      "status": "READ_COMPLETE"
    }
  ],
  "overall_status": "READ_COMPLETE"
}

核心规则

先按最终交付物路由，只加载选定工作流及其明确要求的资料。所有相对路径均以本 skill 根目录为基准。

查询财务、市场、一致预期或公司行动数据前，按强制读取完整性协议完整读取 references/source-tool-priority.md。用户明确指定的工具、网站、文件或数据口径优先于 seed_finance_search；只有指定来源已实际尝试且成功取得、确认不适用或留下可审计的不可用记录后，才能调用 seed_finance_search 补充或降级。用户未指定时，seed_finance_search 仍作为默认高效检索入口。不得静默替换用户指定来源，不得声称调用未实际使用的工具。

每项任务都完整读取 references/model-and-artifact-controls.md。正式建模、公式工作簿或多步骤估值还完整读取：

• references/execution-plan-schema.md
• references/latest-announcement-sweep.md
• references/delivery-package-contract.md

使用股价、每股价值、市值或交易倍数时，另完整读取 references/equity-evidence-acquisition.md。先冻结官方股本与公司行动证据，再建估值日股数桥；验证非 PASS 时停止，不用免责声明绕过。

这些公共协议定义最低门槛。工作流只能增加门槛，不得降低、删除或事后改写阈值。

路由

用户明确点名方法时采用该方法；未点名时按最终交付物选择。仅说“估值”默认 DCF；出现同行、倍数或相对定价时选择可比公司；出现收购、杠杆、退出、MOIC 或 IRR 且关注财务投资人回报时选择 LBO。

不要因 DCF/LBO 内含经营预测而自动加载三表，也不要因需要倍数交叉检查而自动加载可比公司。仅在用户明确要求多个独立交付物时组合：

• 三表 → DCF：先完成可勾稽三表，再映射经营预测和自由现金流口径。
• 三表 → LBO：先完成经营预测，再映射 EBITDA、资本开支、营运资本和现金税；独立计算债务计划。
• DCF + 可比公司：分别形成内在价值与相对价值，解释差异，不机械平均。
• LBO + 可比公司：仅用可比公司支持进入/退出倍数，仍用 LBO 脚本计算回报。

组合任务分别保存各模块的输入、输出、警告和结论；共享数据记录来源与口径转换。

资源隔离

• 公共：scripts/common/、assets/common/ 及公共协议。
• 三表：scripts/three-statements/、assets/three-statements/、references/three-statements-*。
• DCF：scripts/dcf/、assets/dcf/、references/dcf-*。
• LBO：scripts/lbo/、references/lbo-*。
• 可比公司：scripts/comps/、references/comps-*。

单工作流不得加载其他模块资源；组合任务也要先分别通过模块质量门，再比较结果。

执行顺序

1. 宣布所选工作流和理由，按强制读取完整性协议完整读取公共质量门、工作流及其要求的资料；保存 reading-ledger.json，再运行 python3 scripts/common/validate_reading_integrity.py <skill-root> --ledger reading-ledger.json --output reading-integrity.json。reading-integrity.json.status 非 PASS 时停止，不得创建执行计划或开始建模。
2. 对正式任务创建并验证 execution-plan.json。计划只声明要求，不预填“冲突已解决”“无遗漏公司行动”或第二套估值结果。三表明确选择 growth 或 volume_price；有可靠量价数据的资源、矿业、油气和多产品制造公司采用 volume_price。
3. 从模型已纳入的最新财务披露公开日检索至信息截止日，覆盖最新财报、业绩预告/快报、盈利警告、指引变更、重大经营事项、融资和公司行动；保存官方结果页与正文，生成并验证 announcement-sweep.json。存在未处置或 blocking 公告时停止相关结论。
4. 涉及市场价值时，先取得官方基准股本、官方检索结果、每项公司行动正文及文本快照，生成 equity-evidence.json；不得用最新公告扫描替代股本专用证据门。
5. 建立分证券股数桥，运行 scripts/common/validate_equity_evidence.py。通过后，以不复权近端收盘价 × 估值日分证券股数 × 同日汇率反向勾稽独立市值；差异超过 2% 时返回证据和股数桥排错。
6. 按references/data-source-disclosure.md建立data-source-ledger.json，逐字段披露实际采用值、来源、链接、本地证据、报告期、公开日、字段位置、单位、币种、统计口径、调整和冲突选择。
7. 建立assumption-evidence-matrix.json，把重大假设连接到历史序列、业务驱动、外部证据、预测逻辑、相对历史趋势解释和失效条件。DCF逐项披露无风险利率、Beta、股权风险溢价、债务成本、税率、资本结构和永续增长率的依据。
8. 冻结字段映射、模型驱动、情景依据和交付物。区分公开事实、外部估计、分析调整、自主假设和模型推导；不得使用估值日后才公开的信息。
9. 使用工作流指定脚本完成标准化、计算和验证，不用语言模型口算或手填第二套关键结果。未知必需输入保持空白或 NA；只有模块合约明确为“不适用”的可选项才写显式 0。
10. 三表、DCF、LBO和可比公司正式任务均强制生成中文、可编辑、公式驱动的 .xlsx，并将该工作簿作为模型计算、质量审计和在线导入的唯一正式源文件。生成前必须按强制读取完整性协议完整读取 sheet/SKILL.md，并完整读取、遵循 sheet/references/ref-financial-modeling-standards，以生成符合专业金融财务规范的表格。LBO与可比公司默认只生成一个用户可见的表格产物：结论摘要、方法口径、数据来源、风险失效条件和模型检查必须内嵌同一工作簿，不得默认生成或交付Markdown、飞书文档或第二份报告；只有用户明确要求独立报告时才可附加，且不得形成第二套计算或替代该工作簿。本条的“飞书文档”不包括第15条强制交付的飞书在线表格。只解释方法且不输出预测、估值、倍数或回报的非正式问答可不生成工作簿。加载可用的电子表格能力并运行 scripts/common/detect_workbook_engines.py。统一使用OpenPyXL和公共公式语义编译器生成工作簿；不得因环境差异而临时拼接坐标公式。
11. 生成工作簿前按references/model-and-artifact-controls.md建立model-contract.json、formula-contract.json、cell-map.json和布局锁，冻结prompt驱动、关键公式路径、场景、覆盖区域、单位恒等式、反向DCF和检查单元格；禁止语言模型直接手写关键A1坐标公式。
12. 工作簿必须包含“数据来源”“历史数据与口径”“假设依据”和“模型检查”，关键输入通过来源编号或假设编号连接披露台账。保存后关闭并重新打开，以LibreOffice隔离重算并回读，然后只通过统一入口scripts/quality/audit_model.py检查prompt覆盖、公式穿透、场景错位、单位倍率、多证券恒等式、反向DCF残差及静态PASS；再运行现有结构、公式语义、直接产物和视觉审计。
13. 按references/model-and-artifact-controls.md把原子检查整合为G0至G5。运行scripts/quality/run_quality_gates.py生成阶段结果、quality-report.json、release-decision.json和artifact-manifest.json；缺少机器结果不得手填PASS。
14. 按 references/delivery-package-contract.md 打包。工作簿、来源披露、假设证据链、公式语义合约、布局映射、单元格追溯、回读快照和审计结果必须绑定同一最终工作簿SHA-256。最终回答只从release-decision.json读取结论权限；仅当G0至G5全部PASS且conclusion_allowed=true时，才输出目标价、估值区间、上涨下跌空间、MOIC/IRR、推荐倍数、“市场定价合理”或“模型完成”。
15. 最终交付必须采用飞书在线表格。即使用户要求“做个 Excel”“提供 Excel”或“需要 .xlsx 文件”，也必须先按第10至14条生成并审计最终 .xlsx，再调用 lark-cli sheets +workbook-import 将该最终工作簿导入为飞书在线表格。导入对象必须是已完成隔离重算、直接产物审计、质量门检查和SHA-256锁定的最终 .xlsx；不得导入临时文件、未审计版本或与 artifact-manifest.json 哈希不一致的版本。导入成功并取得有效飞书在线表格链接后，必须调用当前环境可用的交付工具，将该链接实际提供给用户。根据运行环境实际提供的工具能力选择交付方式，不得依赖或写死特定工具名称。飞书在线表格是默认用户交付入口；.xlsx 保留为模型源文件、审计对象和导入源文件，可按平台能力或用户明确要求作为附件补充，但不得替代在线表格链接。只有G0至G5全部为 PASS、release-decision.json.conclusion_allowed=true、导入成功、已取得有效链接，且交付工具调用成功并确认用户可获得该链接时，才能声称交付完成。导入失败、链接无效、表格不可访问、不存在任何可用交付工具、工具调用失败或用户无法获得链接时，交付状态必须为 INCOMPLETE，仅报告失败环节、错误信息和修复动作，不得声称在线表格已交付。

不可绕过的结论门

• 摘要、正文、Excel、JSON、情景和敏感性必须引用同一确定性计算内核或来源单元格。
• 最新公告扫描必须覆盖至信息截止日；发现的公告均须纳入、判定不重大或标记为阻断。
• 历史财务必须与正式披露锚点勾稽；三表必须联动且平衡。
• 关键历史财务和估值输入逐字段披露来源链接、报告期、公开日、字段位置、单位、币种和统计口径。
• 重大预测假设形成“历史数据—业务驱动—预测逻辑—模型参数”的证据链，并解释相对历史趋势的变化。
• 股价、股数、汇率、独立市值和公司行动采用同一估值时点口径；A/H/ADR 等证券逐类计算后汇总。
• 量价模型必须显式记录数量、价格、成本、单位与币种换算、产量至销量桥及来源 ID。
• prompt明确要求的每个经营驱动必须在model-contract.json中出现，并沿实际Excel公式依赖到关键输出；只有标签或静态数值不算完成。
• 汇率只能转换价格或价值，不能转换股数；摘要场景、证券类别、单位倍率和源结果必须由统一模型审计逐项复核。
• “模型检查”中的静态PASS不构成审计证据；反向DCF必须将隐含变量代回正向模型并满足市场价值残差容差。
• 工作簿哈希必须与直接审计对象一致，关键派生单元格必须是公式。
• 每个关键公式的实际依赖必须匹配语义合约；引用文本标签、标题、说明、错误假设、错误期间、错误证券、错误单位或未经声明的单元格时阻断。
• 公式依赖图不得存在直接自引用、跨单元格循环或跨工作表循环。最终数值与Python结果巧合一致不能替代依赖和中间节点验证。
• 四个工作流的正式交付均必须包含通过审计的公式工作簿；报告或JSON不得代替工作簿。LBO与可比公司默认用户交付面只出现一个表格产物，并以由最终 .xlsx 导入的飞书在线表格作为强制交付入口；独立报告仅在用户明确要求时附加。
• 免责声明不能恢复被质量门压制的数字；审计环境不可用、结果文件缺失或任一阶段为INCOMPLETE时，只能输出限制、失败检查、待补证据和下一步。
• 最终回答不得自行判断是否可以发布结论，只能遵守统一执行器生成的release-decision.json。
• 任一必需质量门为 FAIL 或 INCOMPLETE 时，保留该状态和原因，不输出被阻断的估值或回报结论。

用简体中文交付。数据不足时给出限制、待补证据和可执行的下一步，不制造伪精确结论。