mcpField
L
lovstudio-expense-report

lovstudio-expense-report

github.com/lovstudioドキュメント7386 回インストール今日更新
リポジトリ

lovstudio-expense-report について

lovstudio-expense-reportは、請求書の画像や経費の説明から、分類済みのExcel精算レポートを作るスキルです。情報を抽出・分類し、明細とカテゴリ別集計のシートを生成する前に内容を確認します。

主な機能

  1. 01画像やテキストから請求書情報を抽出
  2. 02経費をカテゴリ別に分類
  3. 03出力前に抽出内容を確認
  4. 04Excelの明細・集計シートを作成
  5. 05重複の可能性がある請求書を検出

活用シーン

  1. 01スキャンした領収書の精算整理
  2. 02経費説明からカテゴリ別金額を集計
  3. 03レポート作成前の請求書情報確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lovstudio/skills --skill lovstudio-expense-report

インストール後、Claude Code で/lovstudio-expense-reportを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
README.md
scripts/
generate_report.py

詳細

expense-report — 請求書 → カテゴリ別 Excel

画像やテキストから請求書の情報を抽出し、経費を分類して、カテゴリごとの小計を含む見やすい Excel レポートを作成します。

使用する場面

  • ユーザーが処理する請求書の写真やスキャンした領収書を持っている
  • ユーザーが経費をテキストで説明し、整理を希望している
  • ユーザーがカテゴリ別の経費精算レポート（报销单）を必要としている
  • ユーザーが 发票报销、报销汇总、发票整理、expense report について言及している

経費カテゴリ

カテゴリキーワード／例
业务招待客户餐费, 商务宴请, 礼品, 招待
差旅-交通机票, 火车票, 高铁, 出租车, 打车, 网约车, 加油, 过路费, 停车费
差旅-住宿酒店, 住宿, 宾馆
差旅-餐饮出差期间餐费, 工作餐
办公用品文具, 打印, 办公耗材, 办公设备
通讯费话费, 流量, 网费, 宽带
其他以上のカテゴリに該当しない経費

ワークフロー（必須）

ステップ 1：請求書データを収集する

以下のいずれの形式でも入力を受け付けます。

  • 画像：Read ツールを使って請求書の写真を読み取ります。日付、販売元、金額、品目の種類、備考を抽出します。
  • テキストによる説明：ユーザーのテキストから同じ項目を解析します。
  • 混在：複数の画像と補足テキスト。

請求書ごとに、以下の項目を抽出します。

{
  "date": "2026-04-15",
  "vendor": "海底捞(国贸店)",
  "item": "客户餐费",
  "amount": 486.00,
  "category": "业务招待",
  "note": "与XX公司李总晚餐"
}
ステップ 2：分類する

各請求書を上記の表からカテゴリに割り当てます。ルール：

  1. ユーザーがカテゴリを明示している場合は、そのカテゴリを使用します。
  2. 品目や販売元がカテゴリのキーワードに明確に一致する場合は、自動的に割り当てます。
  3. 判断が難しい品目（例：「餐费」は业务招待または差旅-餐饮の可能性があります）の場合：
    • 備考に顧客についての記載がある場合 → 业务招待
    • 出張中の経費である場合 → 差旅-餐饮
    • 判断できない場合は、ユーザーに確認します。
ステップ 3：ユーザーに確認する

作成前に、抽出したデータを表で提示します。

| # | 日期 | 商户 | 项目 | 金额 | 分类 | 备注 |
|---|------|------|------|------|------|------|
| 1 | 2026-04-15 | 海底捞 | 客户餐费 | 486.00 | 业务招待 | 与XX公司李总 |
| 2 | 2026-04-14 | 滴滴出行 | 打车 | 45.50 | 差旅-交通 | 机场→酒店 |

AskUserQuestion を使って、次のように質問します：「以上信息是否正确? 需要修改或补充吗?」

ステップ 4：Excel を作成する

確認済みデータを一時 JSON ファイルに書き込み、次を実行します。

python expense-report-skill/scripts/generate_report.py \
  --input /tmp/invoices.json \
  --output "发票报销汇总-YYYYMMDD.xlsx"

JSON 形式（オブジェクトの配列）：

[
  {"date": "2026-04-15", "vendor": "海底捞", "item": "客户餐费", "amount": 486.0, "category": "业务招待", "note": "与XX公司李总"},
  {"date": "2026-04-14", "vendor": "滴滴出行", "item": "打车", "amount": 45.5, "category": "差旅-交通", "note": "机场→酒店"}
]
ステップ 5：納品する

ユーザーに以下を伝えます。

  • 出力ファイルのパス
  • 合計金額とカテゴリ別内訳
  • 概要を確認するには「分类汇总」シートを確認するよう案内します

出力形式

Excel ファイルには 2 つのシートが含まれます。

  1. 发票报销汇总 — カテゴリごとにグループ化し、小計を含む詳細
  2. 分类汇总 — カテゴリ、件数、小計の概要表

スタイル：Lovstudio の温かみのあるアカデミックなデザイン（土色のヘッダー #CC785C、温かみのあるクリーム色のアクセント）。

例外的なケース

  • 画像がぼやけている／読み取れない：抽出できなかった項目をユーザーに伝え、手動で入力するよう依頼します。
  • 外貨：通貨を記載します。ユーザーが換算レートを提示した場合は CNY に換算し、提示しない場合は元の通貨のまま備考を付けます。
  • 重複請求書：作成前に、重複の可能性がある請求書（日付、販売元、金額が同じもの）を知らせます。
  • 請求書に日付がない：ユーザーが提示した日付を使用するか、「日期不详」と記載します。

コメント

Markdown 対応