Awesome-claude-skills-cn invoice-organizer
通过读取杂乱文件、提取关键信息、一致地重命名并将它们分类到合理的文件夹中,自动整理发票和收据以备税务准备。将数小时的手动记账工作转化为几分钟的自动化整理。
git clone https://github.com/Athe1st3154/awesome-claude-skills-cn
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"
invoice-organizer/SKILL.mdInvoice Organizer
此技能将混乱的发票、收据和财务文档文件夹转换为整洁、税务准备就绪的归档系统,无需手动操作。
何时使用此技能
- 为报税季准备需要整理的记录
- 管理跨多个供应商的业务开支
- 整理混乱文件夹或邮件下载中的收据
- 为持续的簿记设置自动化发票归档
- 按年或类别归档财务记录
- 对账报销费用
- 为会计准备文档
此技能的功能
-
读取发票内容:从 PDF、图像和文档中提取信息:
- 供应商/公司名称
- 发票号码
- 日期
- 金额
- 产品或服务描述
- 付款方式
-
一致地重命名文件:创建标准化的文件名:
- 格式:
YYYY-MM-DD 供应商 - 发票 - 产品或服务.pdf - 示例:
2024-03-15 Adobe - 发票 - Creative Cloud.pdf
- 格式:
-
按类别整理:分类到逻辑文件夹:
- 按供应商
- 按费用类别(软件、办公用品差旅等)
- 按时间段(年、季度、月)
- 按税务类别(可抵扣、个人等)
-
处理多种格式:适用于:
- PDF 发票
- 扫描收据(JPG、PNG)
- 邮件附件
- 截图
- 银行对账单
-
保留原始文件:整理时保留原始文件
使用方法
基本用法
导航到混乱的发票文件夹:
cd ~/Desktop/receipts-to-sort
然后询问 Claude Code:
整理这些发票用于报税
或更具体地:
读取此文件夹中的所有发票,重命名为 "YYYY-MM-DD 供应商 - 发票 - 产品.pdf" 格式, 并按供应商整理
高级整理
整理这些发票: 1. 从每个文件提取日期、供应商和描述 2. 重命名为标准格式 3. 按费用类别分类(软件、办公用品差旅等) 4. 为我的会计创建包含所有发票详情的 CSV 电子表格
说明
当用户请求发票整理时:
-
扫描文件夹
识别所有发票文件:
# 查找所有发票相关文件 find . -type f \( -name "*.pdf" -o -name "*.jpg" -o -name "*.png" \) -print报告发现:
- 总文件数
- 文件类型
- 日期范围(如果可从名称辨别)
- 当前整理情况(或者缺乏)
-
从每个文件提取信息
对于每张发票,提取:
从 PDF 发票:
- 使用文本提取读取发票内容
- 查找常见模式:
- "Invoice Date:"、"Date:"、"Issued:"
- "Invoice #:"、"Invoice Number:"
- 公司名称(通常在顶部)
- "Amount Due:"、"Total:"、"Amount:"
- "Description:"、"Service:"、"Product:"
从图像收据:
- 从图像读取可见文本
- 识别供应商名称(通常在顶部)
- 查找日期(常见格式)
- 找到总金额
对于不清晰文件的回退:
- 使用文件名线索
- 检查文件创建/修改日期
- 如果关键信息缺失则标记供手动审阅
-
确定整理策略
如未指定则询问用户偏好:
找到 [X] 张发票,日期范围为 [日期范围]。 您希望如何整理? 1. **按供应商**(Adobe/、Amazon/、Stripe/ 等) 2. **按类别**(软件/、办公用品/、差旅/ 等) 3. **按日期**(2024/Q1/、2024/Q2/ 等) 4. **按税务类别**(可抵扣/、个人/ 等) 5. **自定义**(描述您的结构) 或者我可以使用默认结构:年/类别/供应商 -
创建标准化文件名
对于每张发票,使用以下模式创建文件名:
YYYY-MM-DD 供应商 - 发票 - 描述.ext示例:
2024-03-15 Adobe - 发票 - Creative Cloud.pdf2024-01-10 Amazon - 收据 - 办公用品.pdf2023-12-01 Stripe - 发票 - 月度支付处理.pdf
文件名最佳实践:
- 删除除连字符外的特殊字符
- 正确大写供应商名称
- 描述保持简洁但有意义
- 使用一致日期格式(YYYY-MM-DD)以便排序
- 保留原始文件扩展名
-
执行整理
移动文件前展示计划:
# 整理计划 ## 建议结构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" -
生成摘要报告
创建包含所有发票详情的 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 适用于:
- 导入会计软件
- 与会计共享
- 费用跟踪和报告
- 税务准备
-
提供完成摘要
# 整理完成! ## 摘要 - **已处理**:[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)
用户:"我有一个用于报税的混乱发票文件夹。整理它们并正确命名。"
流程:
- 扫描文件夹:发现 147 个 PDF 和图像
- 读取每张发票提取:
- 日期
- 供应商名称
- 发票号码
- 产品/服务描述
- 重命名所有文件:
YYYY-MM-DD 供应商 - 发票 - 产品.pdf - 整理到:
、2024/Software/
等2024/Travel/ - 为会计创建
invoice-summary.csv - 结果:几分钟内完成税务准备就绪的整理发票
示例 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 文件夹 并在任何新发票文件到达时使用我们的标准 命名和文件夹结构自动整理它们。
这创建了一个持久解决方案,在发票到达时自动整理。
专业技巧
- 扫描邮件到 PDF:首先使用预览或类似工具将邮件发票保存为 PDF
- 一致下载:将所有发票保存到一个文件夹以便批量处理
- 每月例程:每月而非每年整理发票
- 备份原始文件:重新整理前保留原始文件
- CSV 包含金额:用于预算跟踪
- 按可抵扣性标记:注明哪些费用可抵扣税
- 保留收据 7 年:标准审计期
处理特殊情况
缺失信息
如果无法提取日期/供应商:
- 标记文件供手动审阅
- 使用文件修改日期作为回退
- 创建 "Needs-Review/" 文件夹
重复发票
如果同一发票出现多次:
- 比较文件哈希
- 保留最高质量版本
- 在摘要中注明重复
多页发票
对于跨文件分割的发票:
- 如需要则合并 PDF
- 对各部分使用一致命名
- 在 CSV 中注明发票是否分割
非标准格式
对于不常见的收据格式:
- 提取可能的
- 标准化可标准化的
- 如果关键信息缺失则标记审阅
相关用例
- 为报销创建费用报告
- 整理银行对账单
- 管理供应商合同
- 归档旧财务记录
- 准备审计
- 跟踪订阅费用随时间变化