Awesome-claude-skills-cn invoice-organizer

通过读取杂乱文件、提取关键信息、一致地重命名并将它们分类到合理的文件夹中,自动整理发票和收据以备税务准备。将数小时的手动记账工作转化为几分钟的自动化整理。

install
source · Clone the upstream repo
git clone https://github.com/Athe1st3154/awesome-claude-skills-cn
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Athe1st3154/awesome-claude-skills-cn "$T" && mkdir -p ~/.claude/skills && cp -r "$T/invoice-organizer" ~/.claude/skills/athe1st3154-awesome-claude-skills-cn-invoice-organizer && rm -rf "$T"
manifest: invoice-organizer/SKILL.md
source content

Invoice Organizer

此技能将混乱的发票、收据和财务文档文件夹转换为整洁、税务准备就绪的归档系统,无需手动操作。

何时使用此技能

  • 为报税季准备需要整理的记录
  • 管理跨多个供应商的业务开支
  • 整理混乱文件夹或邮件下载中的收据
  • 为持续的簿记设置自动化发票归档
  • 按年或类别归档财务记录
  • 对账报销费用
  • 为会计准备文档

此技能的功能

  1. 读取发票内容:从 PDF、图像和文档中提取信息:

    • 供应商/公司名称
    • 发票号码
    • 日期
    • 金额
    • 产品或服务描述
    • 付款方式
  2. 一致地重命名文件:创建标准化的文件名:

    • 格式:
      YYYY-MM-DD 供应商 - 发票 - 产品或服务.pdf
    • 示例:
      2024-03-15 Adobe - 发票 - Creative Cloud.pdf
  3. 按类别整理:分类到逻辑文件夹:

    • 按供应商
    • 按费用类别(软件、办公用品差旅等)
    • 按时间段(年、季度、月)
    • 按税务类别(可抵扣、个人等)
  4. 处理多种格式:适用于:

    • PDF 发票
    • 扫描收据(JPG、PNG)
    • 邮件附件
    • 截图
    • 银行对账单
  5. 保留原始文件:整理时保留原始文件

使用方法

基本用法

导航到混乱的发票文件夹:

cd ~/Desktop/receipts-to-sort

然后询问 Claude Code:

整理这些发票用于报税

或更具体地:

读取此文件夹中的所有发票,重命名为
"YYYY-MM-DD 供应商 - 发票 - 产品.pdf" 格式,
并按供应商整理

高级整理

整理这些发票:
1. 从每个文件提取日期、供应商和描述
2. 重命名为标准格式
3. 按费用类别分类(软件、办公用品差旅等)
4. 为我的会计创建包含所有发票详情的 CSV 电子表格

说明

当用户请求发票整理时:

  1. 扫描文件夹

    识别所有发票文件:

    # 查找所有发票相关文件
    find . -type f \( -name "*.pdf" -o -name "*.jpg" -o -name "*.png" \) -print
    

    报告发现:

    • 总文件数
    • 文件类型
    • 日期范围(如果可从名称辨别)
    • 当前整理情况(或者缺乏)
  2. 从每个文件提取信息

    对于每张发票,提取:

    从 PDF 发票

    • 使用文本提取读取发票内容
    • 查找常见模式:
      • "Invoice Date:"、"Date:"、"Issued:"
      • "Invoice #:"、"Invoice Number:"
      • 公司名称(通常在顶部)
      • "Amount Due:"、"Total:"、"Amount:"
      • "Description:"、"Service:"、"Product:"

    从图像收据

    • 从图像读取可见文本
    • 识别供应商名称(通常在顶部)
    • 查找日期(常见格式)
    • 找到总金额

    对于不清晰文件的回退

    • 使用文件名线索
    • 检查文件创建/修改日期
    • 如果关键信息缺失则标记供手动审阅
  3. 确定整理策略

    如未指定则询问用户偏好:

    找到 [X] 张发票,日期范围为 [日期范围]。
    
    您希望如何整理?
    
    1. **按供应商**(Adobe/、Amazon/、Stripe/ 等)
    2. **按类别**(软件/、办公用品/、差旅/ 等)
    3. **按日期**(2024/Q1/、2024/Q2/ 等)
    4. **按税务类别**(可抵扣/、个人/ 等)
    5. **自定义**(描述您的结构)
    
    或者我可以使用默认结构:年/类别/供应商
    
  4. 创建标准化文件名

    对于每张发票,使用以下模式创建文件名:

    YYYY-MM-DD 供应商 - 发票 - 描述.ext
    

    示例:

    • 2024-03-15 Adobe - 发票 - Creative Cloud.pdf
    • 2024-01-10 Amazon - 收据 - 办公用品.pdf
    • 2023-12-01 Stripe - 发票 - 月度支付处理.pdf

    文件名最佳实践

    • 删除除连字符外的特殊字符
    • 正确大写供应商名称
    • 描述保持简洁但有意义
    • 使用一致日期格式(YYYY-MM-DD)以便排序
    • 保留原始文件扩展名
  5. 执行整理

    移动文件前展示计划:

    # 整理计划
    
    ## 建议结构
    

    Invoices/ ├── 2023/ │ ├── Software/ │ │ ├── Adobe/ │ │ └── Microsoft/ │ ├── Services/ │ └── Office/ └── 2024/ ├── Software/ ├── Services/ └── Office/

    
    ## 样本更改
    
    前:`invoice_adobe_march.pdf`
    后:`2024-03-15 Adobe - 发票 - Creative Cloud.pdf`
    位置:`Invoices/2024/Software/Adobe/`
    
    前:`IMG_2847.jpg`
    后:`2024-02-10 Staples - 收据 - 办公用品.jpg`
    位置:`Invoices/2024/Office/Staples/`
    
    处理 [X] 个文件?(是/否)
    

    获批后:

    # 创建文件夹结构
    mkdir -p "Invoices/2024/Software/Adobe"
    
    # 复制(而非移动)以保留原始文件
    cp "original.pdf" "Invoices/2024/Software/Adobe/2024-03-15 Adobe - 发票 - Creative Cloud.pdf"
    
    # 或如果用户偏好则移动
    mv "original.pdf" "new/path/standardized-name.pdf"
    
  6. 生成摘要报告

    创建包含所有发票详情的 CSV 文件:

    日期,供应商,发票号码,描述,金额,类别,文件路径
    2024-03-15,Adobe,INV-12345,Creative Cloud,52.99,软件,Invoices/2024/Software/Adobe/2024-03-15 Adobe - 发票 - Creative Cloud.pdf
    2024-03-10,Amazon,123-4567890-1234567,办公用品,127.45,办公,Invoices/2024/Office/Amazon/2024-03-10 Amazon - 收据 - 办公用品.pdf
    ...
    

    此 CSV 适用于:

    • 导入会计软件
    • 与会计共享
    • 费用跟踪和报告
    • 税务准备
  7. 提供完成摘要

    # 整理完成!
    
    ## 摘要
    - **已处理**:[X] 张发票
    - **日期范围**:最早 到 最晚
    - **总金额**:$[总额](如提取了金额)
    - **供应商**:[Y] 个唯一供应商
    
    ## 新结构
    

    Invoices/ ├── 2024/(45 个文件) │ ├── Software/(23 个文件) │ ├── Services/(12 个文件) │ └── Office/(10 个文件) └── 2023/(12 个文件)

    
    ## 创建的文件
    - `/Invoices/` - 整理好的发票
    - `/Invoices/invoice-summary.csv` - 用于会计的电子表格
    - `/Invoices/originals/` - 原始文件(如已复制)
    
    ## 需要审阅的文件
    [列出信息无法完全提取的文件]
    
    ## 下一步
    1. 审阅 `invoice-summary.csv` 文件
    2. 检查"需要审阅"文件夹中的文件
    3. 将 CSV 导入您的会计软件
    4. 为未来发票设置自动整理
    
    准备好报税季!
    

示例

示例 1:税务准备(来自 Martin Merschroth)

用户:"我有一个用于报税的混乱发票文件夹。整理它们并正确命名。"

流程

  1. 扫描文件夹:发现 147 个 PDF 和图像
  2. 读取每张发票提取:
    • 日期
    • 供应商名称
    • 发票号码
    • 产品/服务描述
  3. 重命名所有文件:
    YYYY-MM-DD 供应商 - 发票 - 产品.pdf
  4. 整理到:
    2024/Software/
    2024/Travel/
  5. 为会计创建
    invoice-summary.csv
  6. 结果:几分钟内完成税务准备就绪的整理发票

示例 2:月度费用对账

用户:"按类别整理上个月的业务收据。"

输出

# 2024 年 3 月收据已整理

## 按类别
- 软件和工具:$847.32(12 张发票)
- 办公用品:$234.18(8 张收据)
- 差旅和餐饮:$1,456.90(15 张收据)
- 专业服务:$2,500.00(3 张发票)

总计:$5,038.40

所有收据已重命名并归档于:
`Business-Receipts/2024/03-March/[类别]/`

CSV 导出:`march-2024-expenses.csv`

示例 3:多年归档

用户:"我有 3 年的随机发票。按年然后按供应商整理。"

输出:创建结构:

Invoices/
├── 2022/
│   ├── Adobe/
│   ├── Amazon/
│   └── ...
├── 2023/
│   ├── Adobe/
│   ├── Amazon/
│   └── ...
└── 2024/
    ├── Adobe/
    ├── Amazon/
    └── ...

每个文件都正确重命名了日期和描述。

示例 4:邮件下载清理

用户:"我从 Gmail 下载发票。它们都命名为'invoice.pdf'、'invoice(1).pdf'等。修复这个混乱。"

输出

发现 89 个文件都命名为 "invoice*.pdf"

读取每个文件以提取真实信息...

重命名示例:
- invoice.pdf → 2024-03-15 Shopify - 发票 - 月度订阅.pdf
- invoice(1).pdf → 2024-03-14 Google - 发票 - Workspace.pdf
- invoice(2).pdf → 2024-03-10 Netlify - 发票 - Pro Plan.pdf

所有文件已重命名并按供应商整理。

常见整理模式

按供应商(简单)

Invoices/
├── Adobe/
├── Amazon/
├── Google/
└── Microsoft/

按年和类别(税务友好)

Invoices/
├── 2023/
│   ├── Software/
│   ├── Hardware/
│   ├── Services/
│   └── Travel/
└── 2024/
    └── ...

按季度(详细跟踪)

Invoices/
├── 2024/
│   ├── Q1/
│   │   ├── Software/
│   │   ├── Office/
│   │   └── Travel/
│   └── Q2/
│       └── ...

按税务类别(会计就绪)

Invoices/
├── Deductible/
│   ├── Software/
│   ├── Office/
│   └── Professional-Services/
├── Partially-Deductible/
│   └── Meals-Travel/
└── Personal/

自动化设置

为持续整理:

创建一个脚本监视我的 ~/Downloads/invoices 文件夹
并在任何新发票文件到达时使用我们的标准
命名和文件夹结构自动整理它们。

这创建了一个持久解决方案,在发票到达时自动整理。

专业技巧

  1. 扫描邮件到 PDF:首先使用预览或类似工具将邮件发票保存为 PDF
  2. 一致下载:将所有发票保存到一个文件夹以便批量处理
  3. 每月例程:每月而非每年整理发票
  4. 备份原始文件:重新整理前保留原始文件
  5. CSV 包含金额:用于预算跟踪
  6. 按可抵扣性标记:注明哪些费用可抵扣税
  7. 保留收据 7 年:标准审计期

处理特殊情况

缺失信息

如果无法提取日期/供应商:

  • 标记文件供手动审阅
  • 使用文件修改日期作为回退
  • 创建 "Needs-Review/" 文件夹

重复发票

如果同一发票出现多次:

  • 比较文件哈希
  • 保留最高质量版本
  • 在摘要中注明重复

多页发票

对于跨文件分割的发票:

  • 如需要则合并 PDF
  • 对各部分使用一致命名
  • 在 CSV 中注明发票是否分割

非标准格式

对于不常见的收据格式:

  • 提取可能的
  • 标准化可标准化的
  • 如果关键信息缺失则标记审阅

相关用例

  • 为报销创建费用报告
  • 整理银行对账单
  • 管理供应商合同
  • 归档旧财务记录
  • 准备审计
  • 跟踪订阅费用随时间变化