财务比率分析 — SKILL.md

何时使用该技能

当用户提出以下请求时使用：

• 针对已连接 QuickBooks Online（QBO）的客户执行财务比率分析
• 盈利能力、流动性、杠杆率或运营效率类指标
• DuPont 分解分析或 Altman Z-Score 分析
• 月度环比（MoM）、季度环比（QoQ）或年度同比（YoY）比率对比
• 与行业平均值进行比率基准比对（benchmarking）
• 连续 6 个月的比率趋势分析
• 任一财务比率的趋势反转检测
• 比率变动的 CDC（Change Data Capture，变更数据捕获）

不适用于以下场景：

• 银行对账 → 使用 bank-reconciliation
• 损益表（P&L）差异分析（明细项下钻）→ 使用 pl-deep-analysis
• 现金流预测 → 使用 cash-flow-forecast
• 应收账款（AR）回款账龄分析 → 使用 ar-collections
• 预算 vs. 实际 → 使用 budget-vs-actual

快速调用方式

# 标准月度比率报告
python3 scripts/pipelines/financial-ratios.py --slug sb-paulson --month 2026-03

# 自定义输出目录
python3 scripts/pipelines/financial-ratios.py --slug  --month 2026-03 --out ~/Desktop/reports

# QBO 沙箱环境
python3 scripts/pipelines/financial-ratios.py --slug sb-paulson --month 2026-03 --sandbox

未知 slug 将使用默认阈值，并在未找到 SOP 文件时禁用存货/估值类比率。

输出内容

Excel 工作簿保存至 ~/Desktop（或 --out 指定路径）：
FinancialRatios_{slug}_{YYYY_MM}.xlsx

比率分类

盈利能力（Profitability）

流动性（Liquidity）

杠杆率（Leverage）

运营效率（Efficiency）

成长性（Growth）

估值类（Valuation，SOP 控制启用）

DuPont 分析

三因子模型

ROE = Net Margin × Asset Turnover × Equity Multiplier

五因子模型

ROE = Tax Burden × Interest Burden × EBIT Margin × Asset Turnover × Equity Multiplier

两种模型均被计算；各成分项均展示其近 6 个月趋势。

Altman Z-Score

破产风险指示器。模型依据 SOP 配置中的 entity_type 自动选择：

Z′ 模型公式：
Z′ = 0.717×(WC/TA) + 0.847×(RE/TA) + 3.107×(EBIT/TA) + 0.420×(BVE/TL) + 0.998×(Revenue/TA)

交通灯评分机制

每个比率根据客户 SOP 中配置的阈值，判定为 GREEN / YELLOW / RED：

• GREEN：处于健康区间内
• YELLOW：需关注 — 接近阈值边界
• RED：需立即采取行动

阈值在脚本内的 CLIENT_CONFIGS 中配置。可通过编辑该字典或添加客户 SOP 文件进行覆盖。

趋势反转检测

该流水线会在 6 个月时间窗口内检测比率是否发生方向反转：

• 比较历史数据前半段与后半段的方向
• 标记为 ⚡ Trend Reversal — Now Improving 或 ⚠ Trend Reversal — Now Declining
• 在 Trends 工作表和 CDC Log 中显著标出

客户 SOP 集成

在 clients/{slug}/sop.md 路径下放置 sop.md 文件。流水线将读取该文件以识别以下信号：

客户配置

在脚本的 CLIENT_CONFIGS 中添加客户配置项，包含：

• ratios_enabled 列表（指定需计算/显示的比率）
• thresholds 字典（按比率分别设定）：{"green": (min, max), "yellow": (min, max)}
• benchmarks 字典（按比率分别设定基准值，类型为 Decimal）
• entity_type：可选 "services" 或 "manufacturing"（用于 Altman Z 模型选择）

从 QBO 获取的数据

QBO 调用总次数：每次运行约 17 次（含 6 个月历史 + 当前月 + 上月 + QoQ + YoY）

CDC 缓存

缓存路径：.cache/financial-ratios/{slug}.json

记录内容包括：

• 上一次运行中全部比率数值
• 逐比率检测变化（绝对差值与百分比变化）
• 在具备完整 6 个月历史时标记趋势反转
• 支持跨次运行对比，用于漂移监控（drift monitoring）

技术说明

• 所有财务计算均使用 Python Decimal 类型（规避浮点精度误差）
• 除零异常：返回 ZERO，永不崩溃
• QBO 数据缺失行：统一填充 ZERO（安全兜底），不导致比率虚高
• 存货周转率：按月度数据年化处理（×12）
• 利息保障倍数：若无利息支出则返回 999.99（表示无债务负担）
• Altman Z-Score 使用账面权益价值（book value of equity）（非市值），适配私营公司模型
• EBITDA = EBIT + D&A；EBIT = 净利润 + 利息支出 + 所得税
• 若 QBO 未单独列示营业利润，则以 EBIT 作为营业利润代理指标计算营业利润率

相关文件