akshare-report

# SKILL.md - akshare-report

## 技能信息

| 属性 | 内容 |
|:---|:---|
| **名称** | akshare-report |
| **版本** | 1.1.0 |
| **分类** | 财报数据 |
| **状态** | ✅ 已上线 |
| **维护者** | FinClaw Core Team |
| **最后更新** | 2026-03-19 |

## 功能描述

财报数据Skill，提供上市公司三大财务报表（资产负债表、利润表、现金流量表）查询、财务指标分析、杜邦分析等功能。

## 触发意图

### 主要触发词
- "财报"、"年报"、"季报"
- "资产负债表"、"利润表"、"现金流量表"
- "ROE"、"毛利率"、"净利率"
- "杜邦分析"、"财务指标"
- "营收"、"净利润"、"现金流"

### Few-shot 示例

| 用户输入 | 识别意图 | 调用函数 |
|:---|:---|:---|
| 茅台财报数据 | financial_report | financial_report.py 600519 |
| 财务指标分析 | financial_indicator | financial_indicator.py 600519 |
| 杜邦分析 | financial_dupont | financial_dupont.py 600519 |
| 最新季报 | financial_report | financial_report.py 600519 --latest |

## 数据源配置

| 数据类型 | 主要来源 | 备用来源 | 认证要求 |
|:---|:---|:---|:---:|
| 三大报表 | AkShare-东方财富 | - | 无需 |
| 财务指标 | AkShare | - | 无需 |

## 三大报表说明

| 报表 | 主要内容 | 关键指标 |
|:---|:---|:---|
| **资产负债表** | 资产、负债、股东权益 | 资产负债率、流动比率 |
| **利润表** | 收入、成本、利润 | 营收、净利润、毛利率 |
| **现金流量表** | 经营/投资/筹资现金流 | 经营现金流、自由现金流 |

## 功能列表

### 1. 三大表数据
- **功能描述**: 获取资产负债表、利润表、现金流量表
- **输入参数**: 股票代码、报表类型（年报/季报）
- **输出格式**: Markdown表格
- **数据源**: AkShare-东方财富
- **数据时效**: 季度更新（财报披露后）
- **使用示例**:
  ```bash
  python scripts/financial_report.py 600519
  python scripts/financial_report.py 600519 --type annual
  ```

### 2. 财务指标
- **功能描述**: 获取核心财务指标
- **输入参数**: 股票代码
- **输出格式**: Markdown表格
- **数据源**: AkShare
- **数据时效**: 季度更新
- **使用示例**:
  ```bash
  python scripts/financial_indicator.py 600519
  ```

### 3. 杜邦分析
- **功能描述**: 进行杜邦分析，拆解ROE驱动因素
- **输入参数**: 股票代码
- **输出格式**: Markdown报告
- **数据源**: AkShare
- **数据时效**: 季度更新
- **使用示例**:
  ```bash
  python scripts/financial_dupont.py 600519
  ```

## 核心财务指标

| 指标 | 公式 | 优秀标准 |
|:---|:---|:---:|
| **ROE** | 净利润/净资产 | >15% |
| **ROA** | 净利润/总资产 | >8% |
| **毛利率** | (营收-成本)/营收 | >30% |
| **净利率** | 净利润/营收 | >10% |
| **资产负债率** | 负债/资产 | <60% |
| **流动比率** | 流动资产/流动负债 | >1.5 |
| **速动比率** | (流动资产-存货)/流动负债 | >1.0 |

## 杜邦分析公式

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

    净利润     营业收入     总资产
  = ────── × ──────── × ────────
    营业收入     总资产       净资产

解读:
- 净利率: 盈利能力
- 资产周转率: 运营效率
- 权益乘数: 财务杠杆
```

## 脚本清单

| 脚本名 | 功能 | 入口点 |
|:---|:---|:---:|
| financial_report.py | 三大表数据 | ✅ |
| financial_indicator.py | 财务指标 | ✅ |
| financial_dupont.py | 杜邦分析 | ✅ |

## 数据来源标注规范

```markdown
---
📊 **数据来源**: AkShare-东方财富
⏱️ **数据时间**: 2026-03-19
📌 **报告期**: 2025年年报
🔗 **原始来源**: 上市公司年报
🔧 **分析工具**: FinClaw v1.0
```

## 依赖要求

```
akshare>=1.10.0
pandas>=1.3.0
pyyaml>=5.4.0
```

## 财报披露日历

| 报告 | 披露时间 |
|:---|:---|
| 一季报 | 4月1日-4月30日 |
| 半年报 | 7月1日-8月31日 |
| 三季报 | 10月1日-10月31日 |
| 年报 | 次年1月1日-4月30日 |

## 更新日志

| 版本 | 日期 | 变更内容 |
|:---|:---:|:---|
| 1.1.0 | 2026-03-19 | 符合FinClaw数据规范v1.0，新增杜邦分析 |
| 1.0.0 | 2026-03-13 | 初始版本 |

---

*本Skill遵循 FinClaw 数据规范 v1.0 | 数据来源强制标注 | 禁止训练数据编造*