# Fb Expense Skill

> 智能报销助手，支持差旅费用报销、发票管理、费用审批、报销进度查询、费用分析等功能。可处理机票、酒店、用车、餐饮等多种费用类型，自动识别发票信息，智能匹配差旅订单。Invoke when user needs to submit expense report, upload invoice, check reimbursement status, or manage travel expenses.

- Skill: `knownasnaffy/fb-expense-skill-4` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/fb-expense-skill-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/fb-expense-skill-4/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/knownasnaffy/fb-expense-skill-4

---





### Permission Setup Review

`python scripts/_setup_logs.py` is an optional setup helper for the `智能报销助手 (fb-expense-skill)` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.

# 智能报销助手 (fb-expense-skill)

## 技能描述

智能报销助手提供一站式差旅费用报销解决方案，支持多种费用类型的录入、发票自动识别、差旅订单关联、审批流程跟踪等功能。通过AI技术实现发票信息自动提取、费用智能分类、报销单自动生成，大幅提升报销效率。

---

⚠️ 【重要约束】
- 必须验证发票真伪和有效性
- 禁止重复报销同一笔费用
- 报销金额不得超过发票金额
- 发票日期必须在报销周期内
- 差旅费用需关联对应的出差申请
- 超标费用需要特殊审批

---

## 核心功能

### 1. 费用录入
- 手动录入费用明细
- 发票拍照/上传自动识别
- 批量导入费用
- 语音录入费用
- 智能费用分类

### 2. 发票管理
- 发票真伪验证
- 发票信息自动提取（金额、日期、税号等）
- 电子发票自动归集
- 发票查重防重复报销
- 发票到期提醒

### 3. 报销单管理
- 自动生成报销单
- 关联差旅订单
- 费用明细汇总
- 报销单编辑/删除
- 报销单提交

### 4. 审批流程
- 审批人自动分配
- 审批进度跟踪
- 审批意见查看
- 审批催办
- 审批历史查询

### 5. 报销查询
- 报销单状态查询
- 报销进度跟踪
- 历史报销记录
- 待报销费用提醒
- 报销统计报表

### 6. 费用分析
- 个人费用分析
- 部门费用统计
- 费用趋势分析
- 预算执行情况
- 异常费用预警

## 触发场景

1. **费用录入**
   - "我要报销上周出差的费用"
   - "录入一笔餐饮费"
   - "上传一张机票发票"
   - "帮我识别这张发票"

2. **报销单管理**
   - "生成这个月的报销单"
   - "查看我的报销单"
   - "修改报销单202403001"
   - "提交报销单"

3. **审批相关**
   - "查看待审批的报销单"
   - "审批通过报销单202403001"
   - "报销单审批进度如何"
   - "催办我的报销单"

4. **查询统计**
   - "查看我的报销记录"
   - "这个月花了多少钱"
   - "查询报销单状态"
   - "生成费用报表"

5. **发票管理**
   - "验证这张发票"
   - "我的发票列表"
   - "发票到期提醒"

## 费用类型

| 费用类型 | 代码 | 说明 | 发票要求 |
|:---|:---|:---|:---|
| 交通费 | TRANSPORT | 机票、火车票、打车费 | 需发票 |
| 住宿费 | HOTEL | 酒店住宿费用 | 需发票 |
| 餐饮费 | MEAL | 工作餐、招待餐 | 需发票 |
| 通讯费 | COMMUNICATION | 电话费、网络费 | 需发票 |
| 办公用品 | OFFICE | 办公用品采购 | 需发票 |
| 差旅补贴 | ALLOWANCE | 出差补贴 | 无需发票 |
| 其他 | OTHER | 其他费用 | 视情况而定 |

## 报销标准

### 差旅标准（按职级）

| 职级 | 飞机舱位 | 火车座位 | 酒店标准（一线城市） | 酒店标准（其他城市） | 餐饮补贴 |
|:---|:---|:---|:---|:---|:---|
| 高管 | 商务舱 | 一等座 | ¥1000/晚 | ¥800/晚 | ¥300/天 |
| 中层 | 经济舱 | 一等座 | ¥800/晚 | ¥600/晚 | ¥200/天 |
| 普通员工 | 经济舱 | 二等座 | ¥500/晚 | ¥400/晚 | ¥150/天 |

### 城市分类

- **一线城市**：北京、上海、广州、深圳
- **新一线城市**：杭州、南京、成都、武汉、西安等
- **其他城市**：上述以外的城市

## 输入参数

### 费用录入

| 参数 | 类型 | 必填 | 说明 |
|:---|:---|:---|:---|
| expense_type | string | 是 | 费用类型代码 |
| amount | float | 是 | 金额 |
| currency | string | 否 | 货币，默认CNY |
| expense_date | string | 是 | 费用发生日期 |
| description | string | 否 | 费用说明 |
| invoice_no | string | 否 | 发票号码 |
| invoice_image | string | 否 | 发票图片URL |
| related_order | string | 否 | 关联订单号 |
| city | string | 否 | 消费城市 |
| attendees | int | 否 | 用餐人数（餐饮费） |

### 报销单创建

| 参数 | 类型 | 必填 | 说明 |
|:---|:---|:---|:---|
| expense_ids | array | 是 | 费用ID列表 |
| trip_id | string | 否 | 关联差旅申请ID |
| remarks | string | 否 | 备注说明 |

### 审批操作

| 参数 | 类型 | 必填 | 说明 |
|:---|:---|:---|:---|
| report_id | string | 是 | 报销单ID |
| action | string | 是 | 操作：approve/reject |
| comment | string | 否 | 审批意见 |

## 输出格式

### 费用录入结果

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "expense_id": "EXP202403300001",
    "expense_type": "TRANSPORT",
    "expense_type_name": "交通费",
    "amount": 850.00,
    "currency": "CNY",
    "expense_date": "2026-03-25",
    "description": "北京-上海机票",
    "invoice_info": {
      "invoice_no": "1234567890",
      "invoice_code": "011001900111",
      "invoice_date": "2026-03-25",
      "seller_name": "中国东方航空股份有限公司",
      "amount": 850.00,
      "tax_amount": 78.44,
      "verification_status": "verified"
    },
    "compliance_check": {
      "within_policy": true,
      "exceed_limit": false,
      "duplicate": false,
      "warnings": []
    },
    "status": "pending",
    "create_time": "2026-03-30 10:30:00"
  }
}
```

### 报销单详情

```json
{
  "code": 0,
  "msg": "success",
  "data": {
    "report_id": "RPT202403300001",
    "report_status": "pending_approval",
    "report_status_name": "待审批",
    "submit_time": "2026-03-30 14:00:00",
    "total_amount": 3250.00,
    "currency": "CNY",
    "expense_count": 5,
    "trip_info": {
      "trip_id": "TRIP202403200001",
      "destination": "上海",
      "start_date": "2026-03-25",
      "end_date": "2026-03-27"
    },
    "expenses": [
      {
        "expense_id": "EXP202403300001",
        "expense_type": "TRANSPORT",
        "expense_type_name": "交通费",
        "amount": 850.00,
        "description": "北京-上海机票"
      },
      {
        "expense_id": "EXP202403300002",
        "expense_type": "HOTEL",
        "expense_type_name": "住宿费",
        "amount": 1200.00,
        "description": "上海酒店2晚"
      }
    ],
    "approval_flow": [
      {
        "step": 1,
        "approver": "部门经理",
        "approver_name": "王经理",
        "status": "pending",
        "comment": ""
      },
      {
        "step": 2,
        "approver": "财务审核",
        "approver_name": "李会计",
        "status": "waiting",
        "comment": ""
      }
    ],
    "remarks": "3月上海出差费用"
  }
}
```

## 展示格式示例

### 费用录入成功

```
✅ 费用录入成功

═══════════════════════════════════════

📋 费用信息
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
费用编号：EXP202403300001
费用类型：🚗 交通费
金额：¥850.00
费用日期：2026-03-25
费用说明：北京-上海机票

═══════════════════════════════════════

🧾 发票信息
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
发票号码：1234567890
发票代码：011001900111
开票日期：2026-03-25
销售方：中国东方航空股份有限公司
金额：¥850.00
税额：¥78.44
验证状态：✅ 已验证

═══════════════════════════════════════

✅ 合规检查
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ 符合报销政策
✓ 未超标准
✓ 无重复报销

═══════════════════════════════════════

💡 操作提示
• 回复"继续录入"添加更多费用
• 回复"生成报销单"提交报销
• 回复"查看费用"查看已录入费用
```

### 报销单详情

```
📄 报销单详情

═══════════════════════════════════════

📋 基本信息
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
报销单号：RPT202403300001
状态：🟡 待审批
提交时间：2026-03-30 14:00:00
总金额：¥3,250.00
费用笔数：5笔

═══════════════════════════════════════

✈️ 关联差旅
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
出差申请：TRIP202403200001
目的地：上海
出差时间：2026-03-25 至 2026-03-27

═══════════════════════════════════════

💰 费用明细
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. 🚗 交通费                              ¥850.00
   北京-上海机票

2. 🏨 住宿费                            ¥1,200.00
   上海酒店2晚

3. 🍽️ 餐饮费                              ¥450.00
   工作餐

4. 🚕 交通费                              ¥180.00
   市内打车

5. 📱 通讯费                              ¥120.00
   漫游费

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
合计：                                    ¥2,800.00
差旅补贴：                                  ¥450.00
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
总计：                                    ¥3,250.00

═══════════════════════════════════════

👥 审批流程
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

第1步：部门审批
审批人：王经理
状态：🟡 审批中
意见：

第2步：财务审核
审批人：李会计
状态：⏳ 待审批
意见：

═══════════════════════════════════════

💡 操作提示
• 回复"催办"提醒审批人
• 回复"撤回"撤回报销单
• 回复"查看发票"查看所有发票
```

### 费用统计报表

```
📊 费用统计报表（2026年3月）

═══════════════════════════════════════

💰 费用总览
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
总费用：¥8,560.00
报销单数：3单
平均单笔：¥2,853.00

═══════════════════════════════════════

📈 费用分类
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🚗 交通费     ¥3,200.00  ████████░░  37%
🏨 住宿费     ¥2,800.00  ███████░░░  33%
🍽️ 餐饮费     ¥1,500.00  ████░░░░░░  18%
📱 通讯费       ¥560.00  █░░░░░░░░░   7%
📝 其他         ¥500.00  █░░░░░░░░░   5%

═══════════════════════════════════════

📅 按日期分布
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
3月25日  ¥2,500.00  ████████░░
3月26日  ¥3,100.00  █████████░
3月27日  ¥1,800.00  █████░░░░░
3月28日  ¥1,160.00  ███░░░░░░░

═══════════════════════════════════════

🎯 预算执行
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
月度预算：¥10,000.00
已使用：   ¥8,560.00
剩余：     ¥1,440.00
执行率：   85.6%

═══════════════════════════════════════

💡 智能提醒
⚠️ 本月餐饮费接近预算上限
✓ 交通费控制在预算范围内
```

## API接口列表

| 接口名称 | 功能 | 参数 |
|:---|:---|:---|
| create_expense | 创建费用 | expense_type, amount, expense_date, description |
| upload_invoice | 上传发票 | image_url, expense_id |
| verify_invoice | 验证发票 | invoice_no, invoice_code |
| get_expense_list | 费用列表 | status, start_date, end_date, expense_type |
| create_report | 创建报销单 | expense_ids, trip_id, remarks |
| get_report_detail | 报销单详情 | report_id |
| get_report_list | 报销单列表 | status, start_date, end_date |
| submit_report | 提交报销单 | report_id |
| approve_report | 审批报销单 | report_id, action, comment |
| get_approval_flow | 审批流程 | report_id |
| get_expense_stats | 费用统计 | start_date, end_date, group_by |
| check_compliance | 合规检查 | expense_id |
| get_budget_status | 预算状态 | year, month |

## 报销状态说明

| 状态 | 说明 |
|:---|:---|
| draft | 草稿 |
| pending | 待提交 |
| pending_approval | 待审批 |
| approved | 已通过 |
| rejected | 已驳回 |
| processing | 财务处理中 |
| paid | 已付款 |
| cancelled | 已取消 |

## 审批流程

### 标准审批流程

```
提交报销单
    ↓
部门经理审批
    ↓
财务审核
    ↓
财务付款
```

### 超标审批流程

```
提交报销单（含超标费用）
    ↓
部门经理审批
    ↓
分管领导审批（超标部分）
    ↓
财务审核
    ↓
财务付款
```

## 合规检查规则

1. **发票验证**
   - 发票真伪验证
   - 发票抬头一致性
   - 发票日期有效性
   - 发票金额合理性

2. **重复检查**
   - 发票号码查重
   - 费用日期和金额查重
   - 关联订单查重

3. **标准检查**
   - 职级标准检查
   - 城市等级标准检查
   - 费用类型限额检查

4. **关联检查**
   - 差旅申请关联
   - 出差日期匹配
   - 目的地匹配