财务比率分析 — SKILL.md

适用场景

在用户提出以下需求时使用：

• 针对已连接 QBO 客户的财务比率分析
• 盈利能力、流动性、杠杆率或运营效率指标
• 杜邦分解或阿尔特曼 Z 分数分析
• 月度环比、季度环比或年度同比比率对比
• 与行业平均水平进行比率基准对比
• 连续 6 个月的比率趋势分析
• 任一财务比率的趋势反转检测
• 比率变动的变更数据捕获（CDC）

不适用场景：

• 银行对账 → 使用 bank-reconciliation
• 利润表差异分析（明细钻取）→ 使用 pl-deep-analysis
• 现金流预测 → 使用 cash-flow-forecast
• 应收账款账龄分析 → 使用 ar-collections
• 预算与实际对比 → 使用 budget-vs-actual

快速调用

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

# 自定义输出目录
python3 scripts/pipelines/financial-ratios.py --slug <client-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

比率分类

盈利能力

流动性

杠杆率

运营效率

增长率

估值（受 SOP 控制）

杜邦分析

三因素模型

ROE = 净利率 × 资产周转率 × 权益乘数

五因素模型

ROE = 税负率 × 利息负担率 × EBIT 利润率 × 资产周转率 × 权益乘数

两种模型均计算，各成分在 6 个月内的趋势均予以展示。

阿尔特曼 Z 分数

破产风险预警指标。根据 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 中配置的阈值，标记为绿色 / 黄色 / 红色：

• 绿色：处于健康区间
• 黄色：需关注 — 接近阈值
• 红色：需采取行动

阈值由脚本中的 CLIENT_CONFIGS 配置。可通过修改字典或添加客户 SOP 文件进行覆盖。

趋势反转检测

该流程可识别比率在 6 个月时间窗口内发生的方向反转：

• 对比历史前半段与后半段的变化方向
• 标记为 ⚡ 趋势反转 — 当前改善中 或 ⚠ 趋势反转 — 当前下滑中
• 在“趋势分析”标签页和“CDC 日志”中显著标注

客户 SOP 集成

将 sop.md 文件放置于 clients/{slug}/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 个月历史数据 + 当前月 + 上月 + 季环比 + 年同比）

CDC 缓存

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

记录内容：

• 上次运行的所有比率数值
• 检测各比率的变化量（delta 与百分比变化）
• 在具备 6 个月历史数据时，标记趋势反转
• 用于运行间对比，监控数据漂移

技术说明

• 所有财务计算均使用 Python Decimal（避免浮点误差）
• 除零情况返回 ZERO，不会导致程序崩溃
• 缺失的 QBO 数据行统一返回 ZERO（安全默认值），不会虚增比率
• 存货周转率：按年化处理（月度数据 × 12）
• 利息保障倍数：当无利息支出时设为 999.99（表示无债务负担）
• Altman Z 分数使用 账面净资产（非市值）计算私企模型
• EBITDA = EBIT + 折旧与摊销；EBIT = 净利润 + 利息 + 税费
• 运营利润率以 EBIT 作为运营收入代理（若 QBO 未单独区分）

文件列表