awesome-codex-skills 实战用 invoice-organizer 自动整理发票构建报税级归档体系【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skillsinvoice-organizer 是 awesome-codex-skills 仓库中一个面向财务归档的实用 Codex Skill它把手动整理发票这类重复性劳动转变成一次自然语言对话扫描杂乱文件、抽取关键信息、标准化重命名、按规则归档并输出会计可直接使用的 CSV 汇总。读完本文你将完整掌握该 Skill 的调用方式、七步执行流程、四类归档模式与异常处理策略并能基于本仓库的源码级机制把它接入自己的 Codex CLI 工作流实现分钟级的报税准备。这个 Skill 解决什么问题invoice-organizer 的定位非常聚焦把充满 PDF、扫描件、邮件附件和截图的无序发票文件夹转化为干净、规范、可直接用于报税的归档体系。其 YAML frontmatter 中对该能力的描述是name: invoice-organizer description: Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders.从 invoice-organizer/SKILL.md 的定义看它具备五类核心能力读取发票内容从 PDF、图片和文档中抽取厂商/公司名、发票号、日期、金额、产品或服务描述、付款方式等字段统一重命名按YYYY-MM-DD Vendor - Invoice - ProductOrService.pdf的规则生成标准化文件名例如2024-03-15 Adobe - Invoice - Creative Cloud.pdf按类别归档支持按厂商、费用类别软件、办公、差旅等、时间段年、季度、月和税务类别可抵扣、个人等排序多格式兼容覆盖 PDF 发票、扫描收据JPG/PNG、邮件附件、截图和银行对账单保留原始文件归档副本而非破坏原文件降低操作风险。典型使用场景报税季前需要整理财务记录跨多个厂商管理企业开支整理从邮件或下载目录散落堆积的收据为持续记账搭建自动化发票归档按年份或类别存档财务记录核对报销单据为会计师准备交接文档。一句话概括凡是一堆发票需要变成一套体系的场景都适合触发该 Skill。安装与启用把 Skill 接入 Codex在使用 invoice-organizer 之前需要先理解本仓库中 Skill 的运行机制。根据 README.md 中 Using Skills in Codex 一节的说明Codex Skill 是一组模块化指令包每个 Skill 拥有独立目录内含带name与descriptionfrontmatter 的SKILL.md。Codex 依据 frontmatter 中的description判断何时触发该 Skill只有触发后才加载正文指令从而保持上下文精简。方式一手动安装最直接将 invoice-organizer 整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/然后重启 Codex 使其重新加载元数据# 确认 Skill 已就位 ls ~/.codex/skills/invoice-organizer # 检查元数据是否完整应包含 name 与 description head ~/.codex/skills/invoice-organizer/SKILL.mdSKILL.md的 frontmatter 是触发匹配的关键。对照仓库中的 template-skill/SKILL.md 可以看到标准模板结构namedescription两行元数据其余为正文指令。README 还提示一个规范的 Skill 目录通常包含SKILL.md必选、scripts/可选确定性操作的辅助脚本、references/可选按需加载的长文档与assets/可选输出用模板或文件——invoice-organizer 属于纯指令型 Skill仅由单文件SKILL.md构成。方式二使用 skill-installer 脚本仓库提供了 skill-installer 目录下的安装脚本核心实现位于 install-skill-from-github.py。从源码看其安装语义包括安装目标为$CODEX_HOME/skills/skill-name默认~/.codex/skills见_default_dest()L267-L268通过--repo owner/repo --path path/to/skill或--url github url指定来源支持--ref分支/标签、--dest目标目录、--name自定义 Skill 名与--method auto|download|git等参数见_parse_argsL271-L290安装前会校验目标目录内必须存在SKILL.md_validate_skillL187-L193且若目标目录已存在同名 Skill 会直接中止_copy_skillL195-L199避免覆盖已有配置。安装完成后重启 Codex并在会话中自然描述任务例如帮我整理发票Codex 便会根据description自动匹配并触发 invoice-organizer。快速上手两种调用方式基本用法进入存放杂乱发票的目录后直接提出整理请求cd ~/Desktop/receipts-to-sort然后对 Codex 说Organize these invoices for taxes或者更明确地指定规则Read all invoices in this folder, rename them to YYYY-MM-DD Vendor - Invoice - Product.pdf format, and organize them by vendor高级用法一次性表达完整诉求让 Skill 按多步计划执行Organize these invoices: 1. Extract date, vendor, and description from each file 2. Rename to standard format 3. Sort into folders by expense category (Software, Office, Travel, etc.) 4. Create a CSV spreadsheet with all invoice details for my accountant七步执行流程详解invoice-organizer 的核心价值体现在其内部定义的、可复现的七步执行流程上。理解这套流程既能更好地驾驭该 Skill也能为自定义自己的财务归档规则提供参考。第一步扫描文件夹当用户请求整理发票时Skill 首先定位所有发票类文件# Find all invoice-related files 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:图片收据扫描件/截图则读取图片中的可见文本同样先找顶部厂商名再匹配常见日期格式与总额。信息不全时的兜底策略借助文件名线索或使用文件创建/修改时间作为日期回退若关键信息确实缺失则标记为需人工复核绝不臆造数据。第三步确定归档策略若用户未指定组织方式Skill 会给出结构化选项征求偏好I found [X] invoices from [date range]. How would you like them organized? 1. **By Vendor** (Adobe/, Amazon/, Stripe/, etc.) 2. **By Category** (Software/, Office Supplies/, Travel/, etc.) 3. **By Date** (2024/Q1/, 2024/Q2/, etc.) 4. **By Tax Category** (Deductible/, Personal/, etc.) 5. **Custom** (describe your structure) Or I can use a default structure: 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日期格式以保证字典序即时间序保留原文件扩展名。第五步执行组织操作移动文件前先展示完整计划征得用户确认# Organization Plan ## Proposed Structure Invoices/ ├── 2023/ │ ├── Software/ │ │ ├── Adobe/ │ │ └── Microsoft/ │ ├── Services/ │ └── Office/ └── 2024/ ├── Software/ ├── Services/ └── Office/ ## Sample Changes Before: invoice_adobe_march.pdf After: 2024-03-15 Adobe - Invoice - Creative Cloud.pdf Location: Invoices/2024/Software/Adobe/ Before: IMG_2847.jpg After: 2024-02-10 Staples - Receipt - Office Supplies.jpg Location: Invoices/2024/Office/Staples/ Process [X] files? (yes/no)用户批准后执行归档命令# Create folder structure mkdir -p Invoices/2024/Software/Adobe # Copy (dont move) to preserve originals cp original.pdf Invoices/2024/Software/Adobe/2024-03-15 Adobe - Invoice - Creative Cloud.pdf # Or move if user prefers mv original.pdf new/path/standardized-name.pdf注意这里的默认取向优先cp而非mv这是对Maintains Originals保留原件能力的落实仅在用户明确偏好时使用mv。第六步生成 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 的典型用途包括导入会计软件、交给会计师、费用跟踪与报表生成、报税准备。第七步输出完成摘要处理完毕后输出结构化总结告知用户产出物与后续动作# Organization Complete! ## Summary - **Processed**: [X] invoices - **Date range**: [earliest] to [latest] - **Total amount**: $[sum] (if amounts extracted) - **Vendors**: [Y] unique vendors ## New Structure Invoices/ ├── 2024/ (45 files) │ ├── Software/ (23 files) │ ├── Services/ (12 files) │ └── Office/ (10 files) └── 2023/ (12 files) ## Files Created - /Invoices/ - Organized invoices - /Invoices/invoice-summary.csv - Spreadsheet for accounting - /Invoices/originals/ - Original files (if copied) ## Files Needing Review [List any files where information couldnt be extracted completely] ## Next Steps 1. Review the invoice-summary.csv file 2. Check files in Needs Review folder 3. Import CSV into your accounting software 4. Set up auto-organization for future invoices Ready for tax season! 摘要同时明确了三个产出物归档后的Invoices/目录、会计用的invoice-summary.csv、以及若采用复制策略时的原始文件备份区并列出待复核文件清单与四项后续建议形成完整闭环。四个实战示例示例 1报税准备来自贡献者 Martin Merschroth用户诉求I have a messy folder of invoices for taxes. Sort them and rename properly.执行过程扫描文件夹找到 147 个 PDF 和图片逐个读取并抽取日期、厂商名、发票号、产品或服务描述全部重命名为YYYY-MM-DD Vendor - Invoice - Product.pdf归档到2024/Software/、2024/Travel/等目录生成invoice-summary.csv交给会计师结果数分钟完成报税就绪的整理。示例 2月度费用核对用户诉求Organize my business receipts from last month by category.输出# March 2024 Receipts Organized ## By Category - Software Tools: $847.32 (12 invoices) - Office Supplies: $234.18 (8 receipts) - Travel Meals: $1,456.90 (15 receipts) - Professional Services: $2,500.00 (3 invoices) Total: $5,038.40 All receipts renamed and filed in: Business-Receipts/2024/03-March/[Category]/ CSV export: march-2024-expenses.csv该示例展示了按月分目录2024/03-March/的组织方式并将金额按类别聚合成月度费用报表。示例 3多年档案归档用户诉求I have 3 years of random invoices. Organize them by year, then by vendor.输出结构Invoices/ ├── 2022/ │ ├── Adobe/ │ ├── Amazon/ │ └── ... ├── 2023/ │ ├── Adobe/ │ ├── Amazon/ │ └── ... └── 2024/ ├── Adobe/ ├── Amazon/ └── ...每个文件均按带日期和描述的规范命名。示例 4邮件下载清理用户诉求I download invoices from Gmail. Theyre all named invoice.pdf, invoice(1).pdf, etc. Fix this mess.输出Found 89 files all named invoice*.pdf Reading each file to extract real information... Renamed examples: - 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 All files renamed and organized by vendor.这个示例说明即使文件名毫无信息量同名序号递增Skill 依然能通过读取文件内容还原真实业务信息这是它区别于按文件名批量改名脚本的本质差异。常见归档结构模式按厂商最简Invoices/ ├── Adobe/ ├── Amazon/ ├── Google/ └── Microsoft/适合厂商数量少、单厂商单据多的场景。按年份 类别报税友好Invoices/ ├── 2023/ │ ├── Software/ │ ├── Hardware/ │ ├── Services/ │ └── Travel/ └── 2024/ └── ...与 Skill 的默认结构一致方便按纳税年度整体移交。按季度精细追踪Invoices/ ├── 2024/ │ ├── Q1/ │ │ ├── Software/ │ │ ├── Office/ │ │ └── Travel/ │ └── Q2/ │ └── ...适合需要季度复盘或按季结账的团队。按税务类别会计就绪Invoices/ ├── Deductible/ │ ├── Software/ │ ├── Office/ │ └── Professional-Services/ ├── Partially-Deductible/ │ └── Meals-Travel/ └── Personal/直接与税务抵扣口径对齐报税时可大幅减少二次分类工作。让流程持续运转自动化设置一次性整理之后还可以把流程做成常驻方案。SKILL.md 给出的触发示例是Create a script that watches my ~/Downloads/invoices folder and auto-organizes any new invoice files using our standard naming and folder structure.即让 Agent 编写一个监视下载目录的脚本新发票一旦落入目录即自动套用既定命名与目录结构完成归档。这样便从一次性整理升级为持续运转的记账管线。专业技巧先把邮件存成 PDF用 Preview 或类似工具把邮件发票先落盘为 PDF便于批量处理统一下载入口把全部发票汇入单一文件夹再批量处理减少扫描范围按月例行整理月度归档比年度突击更可控、更省时备份原件任何重组操作前都保留原始文件CSV 记录金额金额字段对预算追踪与报表极有价值标记可抵扣性注明哪些开支可税务抵扣保留凭证 7 年这是标准的审计留存周期。特殊情况处理信息缺失若无法提取日期或厂商将该文件标记为待人工复核使用文件修改时间作为日期回退建立Needs-Review/文件夹集中放置。重复发票同一发票多次出现时比较文件哈希hash确认是否重复保留质量最高的版本在汇总中标注重复项。多页发票发票拆分在多个文件中时必要时合并 PDF对拆分件使用一致的命名规则在 CSV 中注明该发票为拆分状态。非标准格式遇到非常规收据版式能提取多少就提取多少能标准化的部分尽量标准化关键信息缺失则标记复核。延伸应用invoice-organizer 的指令模式稍作调整即可复用到相邻财务场景SKILL.md 列出的相关用例包括生成报销 expense report整理银行对账单管理供应商合同归档历史财务记录为审计做准备跨期追踪订阅成本。小结invoice-organizer 的价值不在于实现复杂的解析算法而在于把整理发票这一流程固化为可复现、可审计、可扩展的 Skill 指令扫描 → 抽取 → 定策略 → 重命名 → 执行归档 → 出 CSV → 总结复核。结合本仓库的安装机制README.md 中的$CODEX_HOME/skills约定与 skill-installer/scripts/install-skill-from-github.py 的安装语义你可以在一分钟内把它接入 Codex CLI并在数分钟内把数小时的人工整理工作自动化。想了解 Skill 的通用编写规范可进一步阅读 template-skill/SKILL.md 与 README 中的 Creating Skills 一节。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 awesome-codex-skills 实战：用 invoice-organizer 自动整理发票，构建报税级归档体系
awesome-codex-skills 实战用 invoice-organizer 自动整理发票构建报税级归档体系【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skillsinvoice-organizer 是 awesome-codex-skills 仓库中一个面向财务归档的实用 Codex Skill它把手动整理发票这类重复性劳动转变成一次自然语言对话扫描杂乱文件、抽取关键信息、标准化重命名、按规则归档并输出会计可直接使用的 CSV 汇总。读完本文你将完整掌握该 Skill 的调用方式、七步执行流程、四类归档模式与异常处理策略并能基于本仓库的源码级机制把它接入自己的 Codex CLI 工作流实现分钟级的报税准备。这个 Skill 解决什么问题invoice-organizer 的定位非常聚焦把充满 PDF、扫描件、邮件附件和截图的无序发票文件夹转化为干净、规范、可直接用于报税的归档体系。其 YAML frontmatter 中对该能力的描述是name: invoice-organizer description: Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders.从 invoice-organizer/SKILL.md 的定义看它具备五类核心能力读取发票内容从 PDF、图片和文档中抽取厂商/公司名、发票号、日期、金额、产品或服务描述、付款方式等字段统一重命名按YYYY-MM-DD Vendor - Invoice - ProductOrService.pdf的规则生成标准化文件名例如2024-03-15 Adobe - Invoice - Creative Cloud.pdf按类别归档支持按厂商、费用类别软件、办公、差旅等、时间段年、季度、月和税务类别可抵扣、个人等排序多格式兼容覆盖 PDF 发票、扫描收据JPG/PNG、邮件附件、截图和银行对账单保留原始文件归档副本而非破坏原文件降低操作风险。典型使用场景报税季前需要整理财务记录跨多个厂商管理企业开支整理从邮件或下载目录散落堆积的收据为持续记账搭建自动化发票归档按年份或类别存档财务记录核对报销单据为会计师准备交接文档。一句话概括凡是一堆发票需要变成一套体系的场景都适合触发该 Skill。安装与启用把 Skill 接入 Codex在使用 invoice-organizer 之前需要先理解本仓库中 Skill 的运行机制。根据 README.md 中 Using Skills in Codex 一节的说明Codex Skill 是一组模块化指令包每个 Skill 拥有独立目录内含带name与descriptionfrontmatter 的SKILL.md。Codex 依据 frontmatter 中的description判断何时触发该 Skill只有触发后才加载正文指令从而保持上下文精简。方式一手动安装最直接将 invoice-organizer 整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/然后重启 Codex 使其重新加载元数据# 确认 Skill 已就位 ls ~/.codex/skills/invoice-organizer # 检查元数据是否完整应包含 name 与 description head ~/.codex/skills/invoice-organizer/SKILL.mdSKILL.md的 frontmatter 是触发匹配的关键。对照仓库中的 template-skill/SKILL.md 可以看到标准模板结构namedescription两行元数据其余为正文指令。README 还提示一个规范的 Skill 目录通常包含SKILL.md必选、scripts/可选确定性操作的辅助脚本、references/可选按需加载的长文档与assets/可选输出用模板或文件——invoice-organizer 属于纯指令型 Skill仅由单文件SKILL.md构成。方式二使用 skill-installer 脚本仓库提供了 skill-installer 目录下的安装脚本核心实现位于 install-skill-from-github.py。从源码看其安装语义包括安装目标为$CODEX_HOME/skills/skill-name默认~/.codex/skills见_default_dest()L267-L268通过--repo owner/repo --path path/to/skill或--url github url指定来源支持--ref分支/标签、--dest目标目录、--name自定义 Skill 名与--method auto|download|git等参数见_parse_argsL271-L290安装前会校验目标目录内必须存在SKILL.md_validate_skillL187-L193且若目标目录已存在同名 Skill 会直接中止_copy_skillL195-L199避免覆盖已有配置。安装完成后重启 Codex并在会话中自然描述任务例如帮我整理发票Codex 便会根据description自动匹配并触发 invoice-organizer。快速上手两种调用方式基本用法进入存放杂乱发票的目录后直接提出整理请求cd ~/Desktop/receipts-to-sort然后对 Codex 说Organize these invoices for taxes或者更明确地指定规则Read all invoices in this folder, rename them to YYYY-MM-DD Vendor - Invoice - Product.pdf format, and organize them by vendor高级用法一次性表达完整诉求让 Skill 按多步计划执行Organize these invoices: 1. Extract date, vendor, and description from each file 2. Rename to standard format 3. Sort into folders by expense category (Software, Office, Travel, etc.) 4. Create a CSV spreadsheet with all invoice details for my accountant七步执行流程详解invoice-organizer 的核心价值体现在其内部定义的、可复现的七步执行流程上。理解这套流程既能更好地驾驭该 Skill也能为自定义自己的财务归档规则提供参考。第一步扫描文件夹当用户请求整理发票时Skill 首先定位所有发票类文件# Find all invoice-related files 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:图片收据扫描件/截图则读取图片中的可见文本同样先找顶部厂商名再匹配常见日期格式与总额。信息不全时的兜底策略借助文件名线索或使用文件创建/修改时间作为日期回退若关键信息确实缺失则标记为需人工复核绝不臆造数据。第三步确定归档策略若用户未指定组织方式Skill 会给出结构化选项征求偏好I found [X] invoices from [date range]. How would you like them organized? 1. **By Vendor** (Adobe/, Amazon/, Stripe/, etc.) 2. **By Category** (Software/, Office Supplies/, Travel/, etc.) 3. **By Date** (2024/Q1/, 2024/Q2/, etc.) 4. **By Tax Category** (Deductible/, Personal/, etc.) 5. **Custom** (describe your structure) Or I can use a default structure: 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日期格式以保证字典序即时间序保留原文件扩展名。第五步执行组织操作移动文件前先展示完整计划征得用户确认# Organization Plan ## Proposed Structure Invoices/ ├── 2023/ │ ├── Software/ │ │ ├── Adobe/ │ │ └── Microsoft/ │ ├── Services/ │ └── Office/ └── 2024/ ├── Software/ ├── Services/ └── Office/ ## Sample Changes Before: invoice_adobe_march.pdf After: 2024-03-15 Adobe - Invoice - Creative Cloud.pdf Location: Invoices/2024/Software/Adobe/ Before: IMG_2847.jpg After: 2024-02-10 Staples - Receipt - Office Supplies.jpg Location: Invoices/2024/Office/Staples/ Process [X] files? (yes/no)用户批准后执行归档命令# Create folder structure mkdir -p Invoices/2024/Software/Adobe # Copy (dont move) to preserve originals cp original.pdf Invoices/2024/Software/Adobe/2024-03-15 Adobe - Invoice - Creative Cloud.pdf # Or move if user prefers mv original.pdf new/path/standardized-name.pdf注意这里的默认取向优先cp而非mv这是对Maintains Originals保留原件能力的落实仅在用户明确偏好时使用mv。第六步生成 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 的典型用途包括导入会计软件、交给会计师、费用跟踪与报表生成、报税准备。第七步输出完成摘要处理完毕后输出结构化总结告知用户产出物与后续动作# Organization Complete! ## Summary - **Processed**: [X] invoices - **Date range**: [earliest] to [latest] - **Total amount**: $[sum] (if amounts extracted) - **Vendors**: [Y] unique vendors ## New Structure Invoices/ ├── 2024/ (45 files) │ ├── Software/ (23 files) │ ├── Services/ (12 files) │ └── Office/ (10 files) └── 2023/ (12 files) ## Files Created - /Invoices/ - Organized invoices - /Invoices/invoice-summary.csv - Spreadsheet for accounting - /Invoices/originals/ - Original files (if copied) ## Files Needing Review [List any files where information couldnt be extracted completely] ## Next Steps 1. Review the invoice-summary.csv file 2. Check files in Needs Review folder 3. Import CSV into your accounting software 4. Set up auto-organization for future invoices Ready for tax season! 摘要同时明确了三个产出物归档后的Invoices/目录、会计用的invoice-summary.csv、以及若采用复制策略时的原始文件备份区并列出待复核文件清单与四项后续建议形成完整闭环。四个实战示例示例 1报税准备来自贡献者 Martin Merschroth用户诉求I have a messy folder of invoices for taxes. Sort them and rename properly.执行过程扫描文件夹找到 147 个 PDF 和图片逐个读取并抽取日期、厂商名、发票号、产品或服务描述全部重命名为YYYY-MM-DD Vendor - Invoice - Product.pdf归档到2024/Software/、2024/Travel/等目录生成invoice-summary.csv交给会计师结果数分钟完成报税就绪的整理。示例 2月度费用核对用户诉求Organize my business receipts from last month by category.输出# March 2024 Receipts Organized ## By Category - Software Tools: $847.32 (12 invoices) - Office Supplies: $234.18 (8 receipts) - Travel Meals: $1,456.90 (15 receipts) - Professional Services: $2,500.00 (3 invoices) Total: $5,038.40 All receipts renamed and filed in: Business-Receipts/2024/03-March/[Category]/ CSV export: march-2024-expenses.csv该示例展示了按月分目录2024/03-March/的组织方式并将金额按类别聚合成月度费用报表。示例 3多年档案归档用户诉求I have 3 years of random invoices. Organize them by year, then by vendor.输出结构Invoices/ ├── 2022/ │ ├── Adobe/ │ ├── Amazon/ │ └── ... ├── 2023/ │ ├── Adobe/ │ ├── Amazon/ │ └── ... └── 2024/ ├── Adobe/ ├── Amazon/ └── ...每个文件均按带日期和描述的规范命名。示例 4邮件下载清理用户诉求I download invoices from Gmail. Theyre all named invoice.pdf, invoice(1).pdf, etc. Fix this mess.输出Found 89 files all named invoice*.pdf Reading each file to extract real information... Renamed examples: - 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 All files renamed and organized by vendor.这个示例说明即使文件名毫无信息量同名序号递增Skill 依然能通过读取文件内容还原真实业务信息这是它区别于按文件名批量改名脚本的本质差异。常见归档结构模式按厂商最简Invoices/ ├── Adobe/ ├── Amazon/ ├── Google/ └── Microsoft/适合厂商数量少、单厂商单据多的场景。按年份 类别报税友好Invoices/ ├── 2023/ │ ├── Software/ │ ├── Hardware/ │ ├── Services/ │ └── Travel/ └── 2024/ └── ...与 Skill 的默认结构一致方便按纳税年度整体移交。按季度精细追踪Invoices/ ├── 2024/ │ ├── Q1/ │ │ ├── Software/ │ │ ├── Office/ │ │ └── Travel/ │ └── Q2/ │ └── ...适合需要季度复盘或按季结账的团队。按税务类别会计就绪Invoices/ ├── Deductible/ │ ├── Software/ │ ├── Office/ │ └── Professional-Services/ ├── Partially-Deductible/ │ └── Meals-Travel/ └── Personal/直接与税务抵扣口径对齐报税时可大幅减少二次分类工作。让流程持续运转自动化设置一次性整理之后还可以把流程做成常驻方案。SKILL.md 给出的触发示例是Create a script that watches my ~/Downloads/invoices folder and auto-organizes any new invoice files using our standard naming and folder structure.即让 Agent 编写一个监视下载目录的脚本新发票一旦落入目录即自动套用既定命名与目录结构完成归档。这样便从一次性整理升级为持续运转的记账管线。专业技巧先把邮件存成 PDF用 Preview 或类似工具把邮件发票先落盘为 PDF便于批量处理统一下载入口把全部发票汇入单一文件夹再批量处理减少扫描范围按月例行整理月度归档比年度突击更可控、更省时备份原件任何重组操作前都保留原始文件CSV 记录金额金额字段对预算追踪与报表极有价值标记可抵扣性注明哪些开支可税务抵扣保留凭证 7 年这是标准的审计留存周期。特殊情况处理信息缺失若无法提取日期或厂商将该文件标记为待人工复核使用文件修改时间作为日期回退建立Needs-Review/文件夹集中放置。重复发票同一发票多次出现时比较文件哈希hash确认是否重复保留质量最高的版本在汇总中标注重复项。多页发票发票拆分在多个文件中时必要时合并 PDF对拆分件使用一致的命名规则在 CSV 中注明该发票为拆分状态。非标准格式遇到非常规收据版式能提取多少就提取多少能标准化的部分尽量标准化关键信息缺失则标记复核。延伸应用invoice-organizer 的指令模式稍作调整即可复用到相邻财务场景SKILL.md 列出的相关用例包括生成报销 expense report整理银行对账单管理供应商合同归档历史财务记录为审计做准备跨期追踪订阅成本。小结invoice-organizer 的价值不在于实现复杂的解析算法而在于把整理发票这一流程固化为可复现、可审计、可扩展的 Skill 指令扫描 → 抽取 → 定策略 → 重命名 → 执行归档 → 出 CSV → 总结复核。结合本仓库的安装机制README.md 中的$CODEX_HOME/skills约定与 skill-installer/scripts/install-skill-from-github.py 的安装语义你可以在一分钟内把它接入 Codex CLI并在数分钟内把数小时的人工整理工作自动化。想了解 Skill 的通用编写规范可进一步阅读 template-skill/SKILL.md 与 README 中的 Creating Skills 一节。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考