关于 tax-season-organizer
面向小企业主的 Claude 技能,用于整理美国联邦预估税计算和年末 1099 材料,交由会计师审核。它明确列出假设并汇总付款来源;不提供税务建议,也不代为申报。
主要功能
- 01季度预估税计算
- 02汇总承包商付款
- 03检查 1099 门槛和 W-9
- 04生成含假设的会计师材料
适用场景
- 01估算季度联邦税款
- 02整理承包商 1099 审核清单
- 03申报前找出缺失的 W-9
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ anthropics/ knowledge-work-plugins --skill tax-season-organizer安装后在 Claude Code 中输入/tax-season-organizer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
reference/calculation-assumptions.mdconnector-queries.mdgotchas.mdoutput-formats.mdreference/examples/quarterly-estimate.mdyear-end-1099.md详细介绍
报税季整理助手
定位说明: 本技能输出的是供注册会计师(CPA)使用的备税材料,而非税务建议。请尽早说明这一点,并明确列出每一项假设,以便会计师调整。
快速开始
确定用户需要哪种模式,提取相关数据,进行计算或汇总,然后输出一份会计师可以直接使用的结构化文档。
User: "what do I owe for estimated taxes this quarter?"
→ Pull YTD P&L from QuickBooks
→ Calculate estimated federal income tax + SE tax
→ Subtract payments already made this year
→ Show Q-specific amount due with due date and assumptions stated
→ Output: "Estimated Q2 payment due June 16: USD X — see full breakdown below"
User: "I need to send out 1099s"
→ Pull all contractor/vendor payments from QuickBooks + PayPal + Stripe
→ Identify contractors paid ≥ USD 600 YTD
→ Flag records missing W-9 / EIN
→ Output: 1099-NEC candidate list + missing W-9 action list
第 0 步 — 先确认国家
以下两条路径均针对美国联邦税:自雇税、联邦税率表、1099-NEC 和 W-9。在选择模式之前,请读取 ## Business context 区块中的 Country(规则见:../../shared/currency-and-locale.md)。如果缺失,请询问用户。
- 美国 → 继续确定模式。
- 其他国家 → 用一行说明此情况并停止美国税务计算:"此处的季度预缴和 1099 路径是为美国联邦税设计的。您的账簿位于英国,因此我将为您的会计师准备已结账的材料包,而不是美国预估。" 然后提议对相关期间运行
/close-month。不要对非美国企业运行美国税务计算,也不要将其重新标注为通用预估。
输出中的每个金额均以企业的货币代码表示;USD 600 这一条是美国法律规定,并已注明。
确定模式
阅读用户的消息和上下文,以判断适用哪条路径:
- 季度预估 — 关键词:estimated payment、quarterly taxes、how much to set aside、safe harbor、Q1/Q2/Q3/Q4
- 年终 1099 备税 — 关键词:1099、1099-NEC、year-end、contractors、W-9、send 1099s、file 1099s
- 组合 — 部分用户会询问"年终汇总",需要两者都做。先运行 1099 备税,因为它会产生最多的待办事项;季度预估放在最后运行。
如果意图不明确,请询问:"您是要查看本季度的预估税款,还是要为承包商准备 1099 表格——或者两者都要?"
路径 1:季度预估税
1. 提取年初至今的财务数据
使用已连接的账簿系统(MYOB、NetSuite、QuickBooks、Xero 或 Zoho Books — 同类系统,见 ../../shared/connector-neutrality.md),拉取从当年 1 月 1 日到最近完成季度最后一天的损益表(Profit & Loss)。获取以下内容:
- 总收入(总收益)
- 总费用(运营费用、销货成本等)
- 净营业收入 = 收入 − 费用
如果未连接账簿系统,请用户上传 CSV 格式的损益表,或粘贴关键数字。关于各账簿系统的字段名称和查询方法,请参阅 reference/connector-queries.md。
2. 询问已缴预估税款
在计算之前,请询问:"您今年到目前为止已经缴纳了多少预估税?"如果用户不清楚,请说明您将计算总应纳税额——他们可以自行扣减已缴款项,或向会计师确认。
3. 计算预估税负
完整计算过程和必须包含在输出中的假设表,见 reference/calculation-assumptions.md。
第一步,年化。 计算基于预计全年净利润,而非年初至今(YTD)数字:
年化净利润 = YTD 净利润 ÷ 已过月数 × 12。两者都要展示,并加以标注。若为季节性业务,应询问用户,而不是直接线性推算。
简要版本,六个步骤均基于年化净利润:
- SE 税 = 年化净利润 × 0.9235 × 0.153(然后减半,因为可抵扣的一半可抵消收入)
- 调整后净收入 = 年化净利润 − (SE 税 ÷ 2)
- 联邦所得税 = 按用户业务类型和预计年收入适用对应税率(除非用户告知其税档,否则默认按 22% 计算,并明确注明该假设)
- 年度应纳税总额 = 联邦所得税 + SE 税
- 季度应缴金额 = (年度应纳税总额 − 已缴金额)÷ 剩余季度数
- 安全港检查 — 注明用户是否应对照上一年税额进行核实(上一年税额的 100%,若 AGI 超过 15 万美元则为 110%)
如果某个到期日已过且未缴纳,需指明该期限,并将补缴金额单独列一行,与下一期应缴金额分开。罚金和利息交由会计师处理——需标注其适用,但绝不估算。若已无剩余季度,则随申报表一并缴纳。
4. 说明假设并交付输出
完整的分节文档结构见 reference/output-formats.md。
有两点不可妥协:税务年度必须出现在页眉中,并且假设部分必须列出每一项假设——包括税档、业务结构、排除的州税、可抵扣的 SE 税一半,以及未适用的扣除项。会计师会根据这些参数进行调整,遗漏任何一项都会迫使其重新制作。
路径 2:年终 1099 准备
1. 从所有来源提取承包商付款
在每个已连接的来源中,查询税务年度内向个人或企业支付的全部服务费用。不包括商品付款、退款或内部转账。
账本——先尝试实时连接器,若失败则回退到 CSV 导出。 QuickBooks 可能只返回按类别汇总的总额,而不含收款方明细,此时需要用户导出"按供应商划分的交易列表"。Xero 可按联系人提供账单和付款记录,并为美国组织提供 1099 报告摘要。检测逻辑、具体询问措辞以及各账本的列映射,见 reference/connector-queries.md。
PayPal: 提取所有已发出的"商品与服务"付款。注意:PayPal 会就超过门槛的款项向承包商单独开具 1099-K——请在输出中单独标记这些款项,以便会计师判断是否还需要开具 1099-NEC。
Stripe: 提取所有转给外部方的转账/提现。与 PayPal 相同的 1099-K 注意事项同样适用。
Square: 通过该连接器无法获取向外部方的付款(提现款项直接进入业务主人自己的银行账户;承包商薪酬位于 Square Payroll 中,连接器无法访问)。应将其列为来源并注明无可提供的数据,而不是悄悄略去;1099-K 注意事项适用于业务自身的收款。详情见 reference/connector-queries.md。
桌面端/CSV: 若用户直接上传 CSV(未经 QuickBooks 导出),需映射以下列:收款方名称、金额、日期、付款方式、EIN/SSN 状态。
2. 按收款方汇总
跨来源合并,并按个人或企业实体汇总付款金额。按名称去重(注意"John Smith"与"John A. Smith"之类的情况),对可能重复的记录标记供人工复核,而不是自动合并。
3. 应用 600 美元门槛
- 标记为 1099-NEC: 任何因服务(承包商、自由职业者、顾问)支付满 600 美元及以上的收款方
- 标记为 1099-MISC: 任何因租金、律师费、奖金/奖励支付满 600 美元及以上的收款方
- 临界值提醒: 标记支付金额在 400 至 599 美元之间的收款方,它们接近门槛,会计师可能需要核实
公司(Inc.、Corp.、按 C 类或 S 类公司纳税的 LLC)通常不需要 1099-NEC。请注明这一点,但需交由会计师确认。
4. 检查 W-9 状态
对每个被标记的收款方,记录其 W-9 / EIN 是否已存档于账本。标记如下:
- ✅ 已有 W-9(EIN/SSN 已记录在账本的供应商或联系人记录中)
- ⚠️ 缺失:未存有 W-9;必须在申报前收集
- ❓ 未知:无法从现有数据判断
5. 交付 1099 准备材料包
完整的分节结构见 reference/output-formats.md。
最需要重视的部分是:缺失 W-9 行动清单,因为它们会阻碍申报,而截止日期为 1 月 31 日;以及支付处理商说明,因为只通过 PayPal 或 Stripe 获得报酬的承包商可能已经收到 1099-K,会计师需要决定是否还需要 1099-NEC。
护栏
- 每份输出都要注明纳税年度。 reference/calculation-assumptions.md 中的税率档位、工资基数和截止日期均为2025 年数据。若准备其他年度的材料:在显示任何数字之前必须明确说明,然后引用 IRS.gov 上的最新数据,或询问业主。绝不编造税率档位、工资基数或截止日期。
- 非税务建议。 每份交付物开头都要写明:"Prepared for review by your accountant — not tax advice。"(由会计师审阅,非税务建议。)此声明须放在文档页眉中,而不仅仅出现在聊天中。
- 说明所有假设。 如果假设适用 22% 税率档位,要说明;如果排除了州税,也要说明。会计师会据此调整,应为其提供可调整的参数。
- 不要自动合并收款方。 对可能重复的记录标记出来,交由人工复核。
- 不要提交任何文件。 输出只是准备材料,申报不在范围之内。
- 公司豁免属于判断事项。 注明即可,不要自动排除。
- 切勿在材料包、聊天或渲染页面中复现承包商的 SSN 或完整银行账号、卡号。 1099 上的企业 EIN 是唯一被允许的例外(见
../../shared/personal-data.md)。
更多数据源
- Gusto:已实际执行的工资发放数据,包括工资、代扣款项和承包商付款。这能同时增强两种模式:季度预估不再需要猜测工资数据,1099 准备也可以将承包商付款与 Gusto 已申报的数据进行核对。若 Gusto 显示某收款方已开具 1099,应予以标记,而不是重复准备。
- Xero:用于季度路径的损益表;用于收款方名单的按往来单位分类的账单和付款记录;对于美国组织,还包括 1099 报表摘要,可在一次读取中获得路径 2 的预期输出。查询语句见
reference/connector-queries.md。 - Ramp、Expensify:用于季度预估中扣除项部分的卡支出和费用明细,以及有助于确认 1099 名单完整的供应商付款明细。Expensify 的收据筛选功能可以找出无法通过凭证审核的费用,这是会计师在申报前最希望获得的提示。
- MYOB:仅提供损益表,适用于使用 MYOB 的商家。只读,提供三个财年的历史数据,且不包含承包商或供应商收款方明细,因此仅用于季度预估,不参与 1099 准备。
税务计算方式相同,会计师材料包也相同。更多数据源意味着需要说明的假设更少。
Output
按照所有者保存的输出偏好交付估算或 1099 资料包,切勿默认生成 Markdown 文件。 请检查 ## Business context 区块中的 Output preference(共享风格指南规则,../../shared/artifact-style.md):
- 可视化产物(默认): 以公司风格渲染 HTML 页面作为摘要,将估算额或 1099 数量作为首要统计卡片,假设表格,缺失的 W-9 以行的形式呈现并附带一个标签,截止日期置于顶部。开头写明非税务建议的说明。会计师使用的文档本身保留
reference/output-formats.md中的结构。 - docx / md / notion / canva 偏好: 以该形式交付相同内容:DOCX 或 Markdown 文件,通过连接器创建的 Notion 页面(指定目标名称,绝不覆盖),或通过 Canva 连接器创建的 Canva 文档(每次运行都新建设计,并以日期命名;表格转为列表);如果未连接 Notion 或 Canva,则回退为可视化产物,并说明原因。
- Best for 技能: 使用可视化产物,因为此输出是面向会计师文档的状态页面。
资料包之后
估算或 1099 资料包已交给会计师,并已说明假设条件。自然的下一步是“结账本月”,/close-month 可让下一次估算基于已核对的数据运行,而非原始账目。另外相关的还有:“现金预测”(cash-flow-snapshot),用于确认款项能否在到期日到账;以及“谁欠我钱”(invoice-chase),若需要收款来覆盖该笔款项。最多提供三项建议,并跳过所有者在本次会话中已拒绝的建议。
参考文件
- reference/calculation-assumptions.md — 完整的税务计算、2025 年税级表、SE 税计算步骤、年初至今与年化对比、漏缴季度
- reference/output-formats.md — 季度摘要与 1099 资料包两类文档的结构
- reference/connector-queries.md — 如何从各账本(MYOB、NetSuite、QuickBooks、Xero、Zoho Books)、PayPal、Square 和 Stripe 拉取数据,包括供应商级别的回退方案
- reference/gotchas.md — 常见失败模式的正确与错误示例
- reference/examples/quarterly-estimate.md — 季度估算示例
- reference/examples/year-end-1099.md — 年终 1099 准备示例
使用未列出的工具
本技能中提到的连接器是经过测试的路径,而非唯一选择。如果所有者希望此流程使用未连接或未列出的工具,请提供 build-connector:它会先检查连接器目录,否则通过 Zapier 连接,绝不基于原始 API 手动构建。连接建立后,该工具将与其他可选连接器一样加入本技能,并遵守相同的审批关卡。