# Finance Agent

> Record company expenses and generate summary tables. Data is persisted to a CSV file on Google Drive. Supports adding expenses (date, category, amount, description), generating expense tables (CSV, Markdown), and exporting reports.

- Skill: `modbender/finance-agent` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/finance-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/finance-agent/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/finance-agent

---


# finance-agent

**finance-agent** 是一个用于记录公司开销并生成汇总表格的 Agent 技能。所有数据持久化到 Google Drive 的 CSV 文件中，确保数据安全可靠。

## 使用场景

当用户需要以下操作时，请调用本技能：

- 记录一笔新的公司开销（如差旅、餐饮、办公用品等）
- 查看所有开销记录的汇总表格
- 导出开销报告为 CSV 或 Markdown 格式
- 追踪特定类别的开销

## 操作说明

### 添加开销记录

调用 `add_expense` 方法，传入以下参数：

| 参数 | 类型 | 说明 | 示例 |
|------|------|------|------|
| `date` | `str` | 开销日期，格式为 `YYYY-MM-DD` | `"2026-02-28"` |
| `category` | `str` | 开销类别 | `"Travel"`, `"Meals"`, `"Office Supplies"` |
| `amount` | `float` | 开销金额 | `250.75` |
| `description` | `str` | 开销描述 | `"Flight to client meeting"` |

```python
from finance_agent import FinanceAgent

agent = FinanceAgent()
agent.add_expense('2026-02-28', 'Travel', 250.75, 'Flight to client meeting')
```

### 生成开销汇总表格

调用 `generate_expense_table` 方法，通过 `output_format` 参数指定输出格式：

| 格式 | 说明 |
|------|------|
| `"dataframe"` | 返回 Pandas DataFrame 对象（默认） |
| `"csv"` | 返回 CSV 格式字符串 |
| `"markdown"` | 返回 Markdown 格式表格字符串 |

```python
# 生成 Markdown 格式报告
markdown_table = agent.generate_expense_table(output_format='markdown')
print(markdown_table)

# 生成 CSV 格式报告
csv_data = agent.generate_expense_table(output_format='csv')
```

### 导出报告

调用 `export_report` 方法，将报告保存到指定路径：

```python
agent.export_report(output_path='expense_report.csv', output_format='csv')
```

## 数据持久化

本技能使用 CSV 文件进行数据持久化。默认情况下，数据保存在 `expense_report.csv` 文件中。

若需将数据同步到 Google Drive，请确保已正确配置 `GDRIVE_CREDENTIALS` 环境变量，并使用 Google Drive API 将 CSV 文件上传到指定目录。

## 环境变量

| 变量名 | 说明 |
|--------|------|
| `GDRIVE_CREDENTIALS` | Google Drive API 凭据文件路径（JSON 格式） |

## 文件结构

```
finance-agent/
├── SKILL.md                # 本文件，技能说明文档
├── finance_agent.py        # 技能主逻辑实现
└── expense_report.csv      # 开销数据持久化文件（示例数据）
```

## 示例输出

以下是 Markdown 格式的开销汇总表格示例：

| Date       | Category        | Amount | Description                    |
|------------|-----------------|--------|--------------------------------|
| 2026-02-27 | Office Supplies | 55.0   | Printer paper and ink          |
| 2026-02-26 | Travel          | 250.75 | Flight to client meeting       |
| 2026-02-25 | Meals           | 45.5   | Lunch with a potential partner |