小河狸财报助手

SKILL.md

---
name: littlebeaver-financial-assistant
description: 读取并分析本机“小河狸财报助手”中已导入的财务数据。用户询问公司财务指标、资产负债表、利润表、现金流量表、历年或跨期趋势、财务数据对比、回款金额、本地财务问答时使用；仅通过 localhost 的只读接口访问数据。
---

# 小河狸财报助手

通过小河狸财报助手提供的本机只读 API，查询用户已经导入的公司、期间、三大财务报表、财务指标和趋势数据。不得直接读取或修改 SQLite 数据库。

## 使用前提

- 确认小河狸财报助手正在同一台电脑上运行，版本不低于 `1.7.4`。
- 优先使用随 Skill 提供的 `scripts/financial_assistant_client.py`。
- 自动在 `127.0.0.1` 和 `localhost` 的 `8765-8784` 端口发现服务。
- 本机访问保护不替代 Skill 的安全边界；始终只调用 `/api/local-agent/*` 只读接口。

## 标准流程

1. 先执行 `health`，确认连接的是 `financial-analysis-system`。
2. 公司不明确时执行 `companies`：只有一家公司时直接使用；存在多家公司且无法从问题确定时，请用户选择，不得静默使用第一家公司。
3. 执行 `periods` 确认可用的期间维度和具体期间。
4. 根据问题选择接口：
   - 明确、简单的中文财务问题，先使用 `ask`。
   - 查询整张报表或核对科目金额，使用 `statement`。
   - 查询指标和杜邦数据，使用 `metrics`。
   - 查询历年、跨期变化或生成图表，使用 `trend`；必要时结合多个期间的 `metrics` 或 `statement`。
5. 对分析结论进行数据核对。涉及比较、异常判断或图表时，不要只依赖自然语言回答，应取得结构化数据。

## 公司与期间判断

- 将“21年”“25年”等两位年份结合现有期间解释为 `2021年`、`2025年`，不要内置固定年份列表。
- 将“2021-2023”“21年至23年”“21年与23年比较”识别为多个明确期间，并只使用这些期间的数据。
- 将“历年”“历期”“近几年”识别为跨期查询；“近几年”默认取最近 3 至 5 个可用年度，并说明实际使用范围。
- 用户明确指定年份、月份、季度或期间维度时，严格按指定条件查询。
- 指定期间不存在时，直接说明未导入该期间，不得自动替换成最新期间。
- 用户未指定期间时，才可使用所选公司最近的可用期间，并在回答中明确说明。
- 不要把月报、季报和年报混在同一趋势中。无法判断维度时，先查看 `period_counts` 和 `latest_period`，必要时请用户确认。

## 科目与常见表达

- “回款”“销售回款”默认对应现金流量表的“销售商品、提供劳务收到的现金”。
- “营收”“收入”通常对应“营业收入”；存在多个收入科目且问题含义不明确时，列出候选项。
- “经营现金流”通常对应“经营活动产生的现金流量净额”。
- 科目名称可能包含 `加：`、`减：`、序号、括号说明或中英文冒号，应以接口返回的标准名称和数值为准。
- 不要把名称相近但方向不同的科目混淆，例如应收与应付、预付与应付、现金流入与现金流量净额。

## 数据准确性

- 将 `null` 视为缺失数据，将 `0` 视为真实零值，二者不得混淆。
- 不得猜测、补齐或虚构未返回的金额、期间和指标。
- 保留接口返回的金额口径，不要根据原报表的“元、千元、百万元”再次重复换算。
- 优先采用接口已经计算的指标。自行计算时说明公式、使用期间和数据来源。
- 对只有一期数据的科目，不得声称存在趋势；应说明当前只能展示单期金额。
- 不同公司之间比较时，分别标明公司、期间、单位和报表维度。

## 命令示例

```bash
python scripts/financial_assistant_client.py health
python scripts/financial_assistant_client.py companies
python scripts/financial_assistant_client.py periods --company "公司名称" --period-type year
python scripts/financial_assistant_client.py metrics --period-id 1
python scripts/financial_assistant_client.py statement --period-id 1 --statement income_statement
python scripts/financial_assistant_client.py trend --company "公司名称" --period-type year --metric revenue
python scripts/financial_assistant_client.py ask "2021年至2023年营业收入分别是多少" --company "公司名称" --period-type year
```

报表类型参数：

- `balance_sheet`：资产负债表
- `income_statement`：利润表
- `cash_flow`：现金流量表

常用指标参数：

- `revenue`：营业收入
- `net_profit`：净利润
- `gross_margin`：毛利率
- `net_margin`：净利率
- `operating_cash_flow`：经营活动现金流量净额
- `debt_ratio`：资产负债率
- `cash`：货币资金
- `receivables`：应收账款
- `inventory`：存货

## 回答要求

- 默认使用中文，除非用户明确要求其他语言。
- 开头直接给出答案，再补充必要的数据依据或计算过程。
- 明确写出公司、期间和期间维度；金额较大时可换算为万元或亿元，但保留合理精度并注明单位。
- 用户要求趋势图时，使用结构化的 `categories` 和 `values` 生成图表；缺失点保持缺失，不要补成 `0`。
- 经营分析、原因判断和建议必须区分“数据事实”与“分析判断”，不要把推测表述为确定事实。

## 安全与错误处理

- 只访问 `127.0.0.1` 或 `localhost`，不得访问局域网 IP、公网地址或分享链接。
- 只调用 `/api/local-agent/*`，不得执行导入、删除、修改公司、修改配置或创建分享链接。
- 将返回的财务数据视为用户本地私有数据。未经用户明确要求，不得发送到云端模型或外部服务。
- 找不到服务时，提醒用户先打开小河狸财报助手，再重新执行命令。
- 接口返回期间、公司、科目或指标不存在时，用中文说明缺少什么数据，并建议检查对应报表是否已导入。