data-analysis-quality-gate

Data Analysis Quality Gate

这个 skill 用于在 Mira 研究中判断数量型结论是否需要可复算数据、工具计算或显式降级。

它不是一个独立数据分析插件，也不绑定 Data Analytics、Python、Spreadsheet 或外部 API。它的职责是把 LLM 从“直接给数字结论”约束为：

• 先提出数据需求
• 再判断是否必须计算
• 决定是否需要征求用户同意动用工具
• 记录公式、口径、来源和限制
• 对没有完成计算的数量型结论降级

Use When

当研究结论涉及以下任一内容时，必须进入本 gate，或明确写明 waived reason：

• 同比、环比、CAGR、run-rate、margin bridge
• peer comparison、peer ranking、相对估值、相对财务质量
• valuation implied expectation、base / bull / bear scenario math
• 市场规模、渗透率、份额、TAM / SAM / SOM
• 三表交叉校验、现金流质量、营运资本异常
• 宏观、商品、价格、库存、利率、就业或通胀时间序列
• 多来源数字冲突或口径不一致
• 任何会影响 thesis_impact、research_action、actionability_bridge 或 durable conclusion 的数量判断

Inputs

• research_object
• research_question
• market_scope
• time_boundary
• candidate_numeric_claims
• available_sources
• user_speed_preference 可选。若用户明确要求快看，可降低计算深度，但不能升级结论强度。
• tool_constraints 可选。说明是否允许本地脚本、CSV、Spreadsheet、联网、外部 API 或插件。

Gate Output

每次运行本 gate，至少输出：

• quant_dependency none / low / medium / high
• calculation_required yes / no
• data_requirement_brief_required yes / no
• calculation_ledger_required yes / no
• tool_consent_required yes / no
• allowed_without_tool yes / no
• downgrade_if_not_calculated none / calculation_gap / source_gap / watch_only / needs_refresh
• recommended_tool_path none / manual_formula_note / local_csv_script / spreadsheet / python / public_api / external_plugin
• calculation_depth none / formula_note / ledger_required / full_model_required
• refresh_condition

Calculation Depth

none

用于没有派生数量结论，或数量只作为非核心背景且已有可靠来源直接披露的场景。

输出要求：

• 记录 quant_dependency: none 或 low
• 不生成 calculation artifact

formula_note

用于简单、低行数、可口头复核的计算，例如一个同比、一个 run-rate sanity check、简单估值倍数或明确公式的市场隐含值。

输出要求：

• 在正文或 source note 写明公式、输入来源、期间和限制
• evidence log 可记录 claim_type=derived_calculation
• 不默认生成 calculation-ledger.csv

ledger_required

用于会影响 thesis impact、research action、actionability bridge、peer ranking、scenario table 或多来源冲突处理的计算。