财务报表分析技能
/install fin-report-analysis
\r \r
财务报表分析技能\r
\r
概述\r
\r 本技能面向企业财务报表(Excel格式)进行全方位专业分析,输出 Markdown 格式的财务分析报告。\r 报告覆盖五大维度,适用于财务尽调、年度复盘、经营体检等场景。\r \r
触发条件\r
\r 用户上传含有财务数据的 Excel 文件,且请求进行以下任意类型的分析:\r
- 财务报表整体分析 / 财务健康诊断\r
- 资产、负债、利润、现金流增减变动分析\r
- 各项财务比率计算(盈利/偿债/营运/成长能力)\r
- 专家级财务分析总结与改进建议\r \r
工作流程\r
\r
Phase 1:文件接收与预处理\r
\r
- 确认用户已上传 Excel 文件(
.xlsx/.xls/.xlsm)。\r - 如用户未上传,提示:\r
"请上传包含财务数据的 Excel 文件(通常应包含资产负债表、利润表、现金流量表等 Sheet)。"\r
- 确认文件路径后,进入分析阶段。\r \r
Phase 2:运行分析脚本\r
\r
调用 scripts/analyze_financial_report.py 执行自动化分析:\r
\r
python "scripts/analyze_financial_report.py" "\x3Cexcel_file_path>"\r
```\r
\r
脚本将:\r
- 自动检测并匹配 Excel 中的资产负债表、利润表、现金流量表 Sheet(支持中英文名称模糊匹配)\r
- 清洗数据,提取本期/上期两列数值\r
- 输出 Markdown 格式分析报告到同目录下,文件名:`{原文件名}_财务分析报告.md`\r
\r
**环境依赖**:脚本会自动检查并安装 `pandas`、`openpyxl`,无需手动安装。\r
\r
### Phase 3:报告内容说明\r
\r
生成的报告包含五大部分:\r
\r
#### 一、报表项目增减变动分析\r
- 对资产负债表、利润表、现金流量表的每个科目\r
- 列出:本期金额 | 上期金额 | 变动金额(🔺/🔻标注)| 变动率\r
\r
#### 二、资产项目结构变动分析\r
- 以**总资产**为基准(100%)\r
- 计算各资产项目**本期占比**与**上期占比**\r
- 输出占比变动(单位:百分点 pp)\r
\r
#### 三、利润表项目结构变动分析\r
- 以**营业收入**为基准(100%)\r
- 计算各利润表科目**本期占比**与**上期占比**\r
- 输出占比变动\r
\r
#### 四、财务比率综合分析\r
\r
| 类别 | 主要指标 |\r
|------|----------|\r
| 盈利能力 | 毛利率、净利率、ROA、ROE、营业利润率 |\r
| 偿债能力 | 流动比率、速动比率、资产负债率、利息保障倍数、产权比率 |\r
| 营运能力 | 总资产周转率、应收账款周转率(天数)、存货周转率(天数)、流动资产周转率 |\r
| 成长能力 | 收入增长率、净利润增长率、总资产增长率、净资产增长率、营业利润增长率、经营现金流增长率 |\r
\r
#### 五、资深财务专家综合分析与建议\r
- 按盈利能力、偿债能力、成长能力逐项给出数值驱动的评价\r
- 标注核心优势(✅)与风险提示(⚠️/🔴)\r
- 提供 5 条改进建议\r
\r
### Phase 4:结果展示\r
\r
1. 使用 `open_result_view` 展示生成的 Markdown 报告。\r
2. 使用 `deliver_attachments` 将报告文件交付给用户。\r
3. 在回复中用简短语言概括分析亮点与主要发现。\r
\r
## 注意事项\r
\r
- **Sheet 自动匹配**:脚本支持中英文名称模糊匹配(资产负债表/Balance Sheet/资产 等)。\r
若某 Sheet 未能自动匹配,报告中会注明"数据不足",可提示用户检查 Sheet 名称。\r
- **数据格式要求**:Excel 中第一列为科目名,第二列为本期数据,第三列为上期数据(常见格式)。\r
若格式不同(如多年横排),脚本会尝试自适应,但效果因文件而异。\r
- **多年期报表**:若文件包含3年及以上数据,成长能力指标会更有参考意义;\r
当前脚本主要取前两列(本期/上期),如需多年趋势分析,可在报告中补充说明。\r
- **货币单位**:脚本不处理单位换算,报告中数值与原始数据单位一致(元/万元/亿元均可)。\r
- **保密提示**:处理完成后,如用户有数据安全顾虑,建议告知文件仅在本地处理,不上传到外部服务。\r
\r
## 踩坑经验\r
\r
- **资产/负债分Sheet格式**:部分企业将资产负债表拆分为"资产"和"负债"两个Sheet(如本技能测试文件"深圳市羊城晚报文化发展有限公司"),脚本已支持自动检测并合并。\r
- **附注列干扰**:标准报表第2列通常为附注编号(如"附注五"),为非数值列,脚本通过"至少15%行是纯数字"的列识别逻辑自动跳过。\r
- **Sheet简称匹配**:有些文件用"资产"、"负债"、"利润"、"现流"等简称命名Sheet,SHEET_ALIASES中已覆盖这些别名。\r
- **clean_df中的join报错**:pandas读取含NaN的行时,row.astype(str)可能报 `expected str instance, float found`,需改为 `row.fillna("").astype(str)` 才能正确join。\r
- **lambda中float类型报错**:对Series执行apply时,若列中含有float类型值,需在lambda内部调用 `str(v)` 转换后再执行正则匹配。\r
\r
## 错误处理\r
\r
| 场景 | 处理方式 |\r
|------|----------|\r
| 文件未上传 | 提示上传文件 |\r
| 文件格式不是Excel | 提示仅支持 .xlsx/.xls/.xlsm |\r
| Sheet 未匹配到 | 在报告中标注,提示检查Sheet名称 |\r
| 数据列不足(\x3C3列) | 跳过该分析模块,输出提示 |\r
| 脚本运行报错 | 告知错误信息,建议检查文件格式 |\r
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install fin-report-analysis - After installation, invoke the skill by name or use
/fin-report-analysis - Provide required inputs per the skill's parameter spec and get structured output
What is 财务报表分析技能?
财务报表分析技能。当用户上传财务报表 Excel 文件(包含资产负债表、利润表、现金流量表等 Sheet)并请求分析时, 站在资深财务专家视角,自动输出完整的财务分析报告,包含:报表项目增减变动表、 资产结构变动表、利润表结构变动表、财务比率综合分析(盈利/偿债/营运/成长能力指标), 以及专家综合分析总结与建议... It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.
How do I install 财务报表分析技能?
Run "/install fin-report-analysis" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 财务报表分析技能 free?
Yes, 财务报表分析技能 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 财务报表分析技能 support?
财务报表分析技能 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 财务报表分析技能?
It is built and maintained by yinfeihaaaaaaaaaaa (@yinfeihaaaaaaaaaaa); the current version is v1.0.0.