Skillppx logo

Cash Flow Forecast

基于 QuickBooks Online 数据生成13周滚动现金流预测，支持三种情景分析。

已扫描
适合谁
财务顾问、初创企业创始人
不适合谁
需要年度预算的用户、进行银行对账的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @samledger67-dotcom/cash-flow-forecast
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

现金流预测技能

适用场景

  • 客户要求提供13周（或滚动n周）的现金流预测
  • 需要为高烧钱客户（如GlowLabs类型）预测资金耗尽时间
  • 按月或按季度交付的现金流咨询报告
  • 任何需要监控现金状况或进行情景模拟的情况
  • 客户SOP中标记“现金流预测：✅”时使用

不适用场景

  • 历史现金流分析（请使用P&L深度分析流程）
  • 银行对账（请使用bank-reconciliation.py）
  • 全面的现金流审计（请直接使用QBO现金流报表）
  • 资产负债表预测 / 完整财务模型

脚本位置

scripts/pipelines/cash-flow-forecast.py

快速开始

cd /Users/samshouse/.openclaw/workspace

# 标准13周预测
python3 scripts/pipelines/cash-flow-forecast.py --slug glowlabs

# 获取6个月历史数据以更好体现季节性
python3 scripts/pipelines/cash-flow-forecast.py --slug sb-paulson --months 6

# 自定义低现金阈值（GlowLabs：高烧钱）
python3 scripts/pipelines/cash-flow-forecast.py --slug glowlabs \
    --low-cash-threshold 50000 \
    --critical-threshold 25000 \
    --out ~/Desktop/reports

# 沙箱测试
python3 scripts/pipelines/cash-flow-forecast.py --slug glowlabs --sandbox

所有CLI选项

参数默认值说明
--slug必填QBO公司标识符
--weeks13预测周期（周数）
--months3拉取的历史现金流月数（1–6）
--low-cash-threshold25000当余额低于此值时发出警告
--critical-threshold10000当余额低于此值时触发严重警报
--accountauto指定银行账户名称过滤器
--out~/Desktop输出目录
--sandboxfalse使用QBO沙箱环境

输出Excel工作表

表1：现金流概览

  • 当前现金余额（来自资产负债表的所有银行/现金账户）
  • 13周关键指标汇总：总流入、总流出、净现金流、期末余额
  • 烧钱率与资金耗尽时间（以突出框形式展示）
  • 完整的每周轨迹表格，包含预警颜色标记
  • 顶部打印SOP备注（客户特定警告）

表2：每周明细

  • 矩阵结构：每行代表一个现金流子类别，每列代表一周
  • 流入部分（绿色）→ 流出部分（红色）
  • 各项小计、净现金流行、累计余额行
  • 预警颜色标记：黄色 = 警告，橙色/红色 = 严重

表3：情景对比

  • 并列显示：基准 | 乐观 | 悲观
  • 12个关键指标行：流入、流出、净额、期末余额、烧钱率、资金耗尽时间、预警周数
  • 三种情景下每周余额对比表格
  • 最佳/最差情景差异及百分比波动列

表4：烧钱率分析

  • 详细烧钱指标（基准情景）
  • 三种情景下的资金耗尽时间对比表
  • 每周烧钱趋势图
  • 🔴 对GlowLabs类客户强调高烧钱特征

表5：假设条件

  • 所有使用参数（阈值、调整项、季节性权重）
  • 各类别月均值（作为基线使用）
  • 客户SOP配置摘要
  • 方法论说明

表6：CDC日志

  • 运行间变化：期初现金、烧钱率、资金耗尽时间
  • 预测准确性：将上一次运行预测的期初现金与实际值对比
  • 首次运行：保存基线数据；后续运行显示变化量

情景定义

情景收款情况费用情况
基准历史平均值历史平均值
乐观+10%保持不变
悲观-15%+5%

现金流分类

自动从QBO现金流条目中分类：

运营 — 流入

  • collections：收入、应收账款、净利润、支付处理器收款
  • interest：利息收入

运营 — 流出

  • payroll：工资、薪金、高管薪酬、Deel（GlowLabs）
  • rent：租金、租赁、占用费
  • vendors：应付账款、销货成本、专业服务费、软件订阅等
  • interest：利息支出（SB Paulson：重要项目）
  • taxes、insurance

投资

  • capex：设备、房产、资产购置

融资

  • debt：贷款、信用额度、应付票据
  • equity：所有者分配/出资
  • safe：SAFE条款（GlowLabs）

客户SOP集成

脚本会自动读取 clients/{slug}/sop.md 并相应调整行为：

SOP信号效果
"burn rate", "runway", "high cash burn"强调烧钱率表格，添加 🔴 警报
"interest expense"单独追踪利息支出
"POS collection", "collected at POS"无应收账款滞后期 — 每周流入均匀分布
"accounts receivable"基于应收账款：注明30-45天到账滞后期
"SAFE"添加SAFE融资类别
"crypto", "wallet", "ETH"添加加密钱包备注
"Deel"将Deel收入归类为费用减少项

季节性权重

默认的每月周分布（可在脚本CONFIG部分配置）：

周次流入占比流出占比说明
第1周（第1–7天）30%35%收款/薪资较早到账
第2周（第8–14天）20%20%月中平静期
第3周（第15–21天）20%25%中旬薪资+租金
第4周（第22–28天）30%20%月末集中收款
第5周（溢出）0%0%极少使用

POS客户（如SB Paulson）：流入按每周均等分布。

CDC准确性循环

  1. 首次运行：保存 starting_cash、first_week_balance、avg_monthly_burn、months_of_runway
  2. 第二次运行：将新 starting_cash 与上次 first_week_balance 对比
  3. 准确率 = 预测值与实际值接近程度
  4. 烧钱率和资金耗尽时间的变化量逐轮跟踪
  5. 缓存存储于 .cache/cash-flow-forecast/{slug}.json

低现金预警颜色

颜色Excel填充条件
✅ 正常白色余额 ≥ 低阈值
⚠ 警告黄色余额 < 25,000美元（可配置）
🔴 严重橙色/红色余额 < 10,000美元（可配置）

客户特定备注

GlowLabs（高烧钱模式）

  • 推荐参数：--low-cash-threshold 50000 --critical-threshold 25000
  • SOP 自动识别：现金流消耗速率表格以红色标题突出显示
  • SAFE 融资和 Deel 类别自动分类
  • 退场时间（Runway）为首要关键绩效指标（KPI），在摘要页中显著展示

SB Paulson / Willo Salons

  • 建议设置 --months 6，以更好反映季节性特征（美发店业务具有明显季节性）
  • POS 收款 = 无应收账款延迟；收入在每周间分布均匀
  • 利息支出作为独立的运营支出类别进行追踪
  • 现金流预测频率：按季度提供咨询建议（依据 SOP）

依赖项

pip install openpyxl

Node.js QBO 客户端必须使用有效令牌完成认证。

输出文件命名

CashFlowForecast_{slug}_{YYYY-MM-DD}.xlsx

默认输出路径：~/Desktop/

相关流程

  • pl-quick-compare.py — 利润表差异分析
  • pl-deep-analysis.py — 控制员层级，支持总账明细钻取
  • bank-reconciliation.py — 银行对账单核对
SD
@samledger67-dotcom

已收录 4 个 Skill

相关推荐