SKILL.md
readonly只读
name
invoice-organizer
description
自动整理发票和收据，为报税做准备。通过读取杂乱文件、提取关键信息、统一重命名并归类到逻辑文件夹中，将数小时的手工记账工作缩短为几分钟的自动化整理。
发票整理器
此技能可将杂乱的发票、收据和财务文档文件夹转换为整洁、随时可用于报税的归档系统，无需手动操作。
何时使用此技能
- 为报税季做准备，需要整理记录
- 管理跨多个供应商的业务费用
- 整理来自杂乱文件夹或邮件下载的收据
- 设置自动发票归档以持续记账
- 按年份或类别归档财务记录
- 核对报销费用
- 为会计师准备文档
此技能的功能
-
读取发票内容：从 PDF、图片和文档中提取信息：
- 供应商/公司名称
- 发票编号
- 日期
- 金额
- 产品或服务描述
- 付款方式
-
统一重命名文件：创建标准化文件名：
- 格式：
YYYY-MM-DD Vendor - Invoice - ProductOrService.pdf - 示例：
2024-03-15 Adobe - Invoice - Creative Cloud.pdf
- 格式：
-
按类别整理：归类到逻辑文件夹：
- 按供应商
- 按费用类别（软件、办公、差旅等）
- 按时间段（年、季度、月）
- 按税务类别（可抵扣、个人等）
-
处理多种格式：支持：
- PDF 发票
- 扫描的收据（JPG、PNG）
- 邮件附件
- 截图
- 银行对账单
-
保留原件：整理副本的同时保留原始文件
使用方法
基本用法
导航到杂乱的发票文件夹：
cd ~/Desktop/receipts-to-sort
然后向 Claude Code 提问：
整理这些发票用于报税
或更具体地：
读取此文件夹中的所有发票，重命名为
"YYYY-MM-DD Vendor - Invoice - Product.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] 张发票，日期范围从 [date range]。 您希望如何整理它们？ 1. **按供应商**（Adobe/, Amazon/, Stripe/ 等） 2. **按类别**（Software/, Office Supplies/, Travel/ 等） 3. **按日期**（2024/Q1/, 2024/Q2/ 等） 4. **按税务类别**（Deductible/, Personal/ 等） 5. **自定义**（描述您的结构） 或者我可以使用默认结构：Year/Category/Vendor -
创建标准化文件名
为每张发票创建遵循以下模式的文件名：
YYYY-MM-DD Vendor - Invoice - Description.ext示例：
2024-03-15 Adobe - Invoice - Creative Cloud.pdf2024-01-10 Amazon - Receipt - Office Supplies.pdf2023-12-01 Stripe - Invoice - Monthly Payment Processing.pdf
文件名最佳实践：
- 除连字符外，移除特殊字符
- 正确大写供应商名称
- 保持描述简洁但有意义
- 使用一致的日期格式（YYYY-MM-DD）以便排序
- 保留原始文件扩展名
-
执行整理
在移动文件之前，显示计划：
# 整理计划 ## 建议结构Invoices/
├── 2023/
│ ├── Software/
│ │ ├── Adobe/
│ │ └── Microsoft/
│ ├── Services/
│ └── Office/
└── 2024/
├── Software/
├── Services/
└── Office/## 示例更改 之前：`invoice_adobe_march.pdf` 之后：`2024-03-15 Adobe - Invoice - Creative Cloud.pdf` 位置：`Invoices/2024/Software/Adobe/` 之前：`IMG_2847.jpg` 之后：`2024-02-10 Staples - Receipt - Office Supplies.jpg` 位置：`Invoices/2024/Office/Staples/` 处理 [X] 个文件？（是/否）获得批准后：
# 创建文件夹结构 mkdir -p "Invoices/2024/Software/Adobe" # 复制（不移动）以保留原件 cp "original.pdf" "Invoices/2024/Software/Adobe/2024-03-15 Adobe - Invoice - Creative Cloud.pdf" # 如果用户偏好，也可以移动 mv "original.pdf" "new/path/standardized-name.pdf" -
生成摘要报告
创建一个包含所有发票详情的 CSV 文件：
Date,Vendor,Invoice Number,Description,Amount,Category,File Path 2024-03-15,Adobe,INV-12345,Creative Cloud,52.99,Software,Invoices/2024/Software/Adobe/2024-03-15 Adobe - Invoice - Creative Cloud.pdf 2024-03-10,Amazon,123-4567890-1234567,Office Supplies,127.45,Office,Invoices/2024/Office/Amazon/2024-03-10 Amazon - Receipt - Office Supplies.pdf ...此 CSV 可用于：
- 导入会计软件
- 与会计师共享
- 费用跟踪和报告
- 报税准备
-
提供完成摘要
# 整理完成！📊 ## 摘要 - **已处理**：[X] 张发票 - **日期范围**：[最早] 至 [最晚] - **总金额**：$[sum]（如果提取了金额） - **供应商**：[Y] 个不同供应商 ## 新结构Invoices/
├── 2024/ (45 个文件)
│ ├── Software/ (23 个文件)
│ ├── Services/ (12 个文件)
│ └── Office/ (10 个文件)
└── 2023/ (12 个文件)## 创建的文件 - `/Invoices/` - 整理后的发票 - `/Invoices/invoice-summary.csv` - 用于会计的电子表格 - `/Invoices/originals/` - 原始文件（如果已复制） ## 需要审查的文件 [列出无法完整提取信息的文件] ## 后续步骤 1. 检查 `invoice-summary.csv` 文件 2. 查看 "Needs Review" 文件夹中的文件 3. 将 CSV 导入您的会计软件 4. 为未来的发票设置自动整理 报税季准备就绪！🎉
示例
示例 1：报税准备（来自 Martin Merschroth）
用户：“我有一个杂乱的发票文件夹用于报税。请整理并正确重命名。”
过程：
- 扫描文件夹：找到 147 个 PDF 和图片
- 读取每张发票以提取：
- 日期
- 供应商名称
- 发票编号
- 产品/服务描述
- 重命名所有文件：
YYYY-MM-DD Vendor - Invoice - Product.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/[Category]/`
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 - Invoice - Monthly Subscription.pdf
- invoice(1).pdf → 2024-03-14 Google - Invoice - Workspace.pdf
- invoice(2).pdf → 2024-03-10 Netlify - Invoice - 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 中注明
非标准格式
对于不寻常的收据格式：
- 提取可能的信息
- 标准化能标准化的部分
- 如果关键信息缺失，标记以供审查
相关用例
- 创建报销用的费用报告
- 整理银行对账单
- 管理供应商合同
- 归档旧的财务记录
- 为审计做准备
- 跟踪订阅费用随时间的变化
