)
knowledge-work-plugins 实战invoice-chase 逾期账款追收技能全解析QuickBooks 应收 PayPal 交叉核验 分级催收邮件【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本文以 invoice-chase SKILL.md 为骨架结合其 tone-matching.md、gotchas.md 与两封示例邮件系统拆解这套逾期账款追收技能的完整工作流如何从 QuickBooks 拉取 AR 账龄报表、用 PayPal 结算流水交叉核验疑似已付、按 12 个月付款历史给客户打分级标签并为每张逾期发票生成语气匹配的催收邮件。读完本文你将掌握该技能的全部配置项、查询参数、评分规则、邮件模板结构与审批门禁可直接在 Cowork / Claude Code 中驱动这套谁欠我钱追收流程。技能定位invoice-chase 在插件库中的角色invoice-chase 是 small-business 插件下 15 个 building-block 技能之一属于Money finance模块。它的职责非常单一把逾期应收款变成待老板审批的催收邮件草稿。根据 small-business/README.md 的技能清单它要求连接 QuickBooks必需可选连接 PayPal、Stripe 与 Gmail。技能本身不直接对用户暴露而是通过自然语言触发。只要用户说出who owes me money、overdue invoices、follow up on unpaid或者更口语化的谁欠我钱、催一下没付的款技能就会启动。它同时也是/plan-payroll发薪保障命令链条的一环——在 plan-payroll SKILL.md 中invoice-chase 作为 Step 2 被调用用于在现金预测发现缺口后把催收哪些逾期账款变成可量化的补缺口方案。技能元数据SKILL.md 的 frontmatter给出了核心约定name: invoice-chase版本0.2.0职责根据 QuickBooks 与 PayPal 数据起草逾期发票提醒邮件按每个客户的付款历史匹配语气对优质客户温和、对反复逾期者强硬发送方式走 PayPal 发送需老板批准非 PayPal 发票排队为邮件草稿核心约束在老板明确表态之前什么都不发送。Quick start一次追收的完整链条技能开篇用一段流水线式的伪代码概括了全流程这也是理解本文后续所有细节的总纲User: who owes me money → Pull AR aging from QuickBooks → Cross-reference PayPal settlements (last 14 days) → Score each customer: good-payer / occasionally-late / repeat-late → Draft tone-matched reminders → Show summary table drafts. Wait for send these.注意此处的last 14 days是技能描述中的概括性说法实际工作流见下文PayPal 交叉核验一节明确规定查询窗口为最近 7 天以避免 PayPal 的 429 限流——这是文档内部需要以更严谨实现为准的细节后文会展开。整个流程贯穿一条铁律所有动作在老板说发送之前都只是草稿。技能七步工作流中的每一步都为此服务拉数据第 1 步、核验第 2 步、评分第 3 步、起草第 4 步、展示第 5 步、审批后发送或排队第 6 步、汇报第 7 步。首次运行的 Setup只问两次问题与其他需要大量配置的技能不同invoice-chase 的首次配置极其克制——只问两个问题且之后不再重复询问邮件连接器Do you use Gmail or Apple Mail for drafts?你用 Gmail 还是 Apple Mail 存草稿——答案会被保存用于所有非 PayPal 发票的草稿排队。StripeDo you use Stripe for invoicing? I can include Stripe invoices in the overdue sweep.你用 Stripe 开票吗我可以把 Stripe 的逾期发票一并纳入清查。——若回答是后续每次运行都会把 Stripe 逾期发票与 QuickBooks 一起拉取。这两个问题的设计意图很清晰技能把是否启用与发送通道这类一次性的环境事实固化下来让后续每次运行直接进入数据流水线不打扰老板。七步工作流详解第 1 步拉取逾期应收查询 QuickBooks 的AR aging应收账龄筛出逾期超过 1 天的全部发票即more than 1 day past due。如果 Setup 阶段确认启用了 Stripe则同时拉取 Stripe 的逾期发票。这里有一个隐藏的过滤逻辑完整描述见 gotchas.mdQuickBooks AR 可能包含内部或测试账户。部分账套中存在内部记账账户或测试记录起草邮件前必须过滤掉邮箱域名与老板自身域名相同的客户并对客户名称中包含 Test、Internal、Demo 的记录打标提示。否则可能出现给自家测试账号发催款信的低级事故。第 2 步PayPal 交叉核验付款历史对每个逾期客户用以下参数查询 PayPal 已结算交易transaction_status: S仅已结算 settled 交易——过滤掉 pending 与 denied 交易它们会虚增结果集大小并放大限流风险日期窗口截至今天的最近 7 天不是 14 天或 30 天——更宽的窗口是 PayPal 429 限流错误的首要原因参见 gotchas.md。如果客户在查询窗口内有已结算付款则标记为possibly paid — verify疑似已付待核实并将其排除出草稿队列。429 限流的完整降级策略这是本技能最值得注意的健壮性设计7 天窗口查询返回 429 →立即用 3 天窗口重试一次更窄的窗口减小响应负载通常能成功3 天重试仍然 429 →本次运行完全跳过 PayPal 交叉核验把批次内所有客户在汇总表中标记为PayPal unavailable — verify manuallyPayPal 不可用——请人工核实仅凭 QuickBooks 历史进行评分不得静默丢弃这个警示——老板在批准任何发送之前必须知道交叉核验被跳过了。第 3 步客户评分根据 tone-matching.md 的评分逻辑为每个客户打上good-payer/occasionally-late/repeat-late三档标签。完整评分规则见下文专节。第 4 步起草催收邮件规则每个客户一封邮件同一客户的多个逾期发票合并进一封邮件。语气严格匹配评分结果。模板结构见 examples/gentle-reminder.md好客户与 examples/firm-reminder.md反复逾期客户。第 5 步向老板展示草稿先展示汇总表格式如下来自 SKILL.mdCustomerAmount DueDays LateToneSend viaAcme Corp$1,20018 daysGentlePayPalSmith LLC$45047 daysFirmGmail draft然后完整展示每封邮件草稿全文。之后等待老板说 send these 或逐封批准。第 6 步批准后才发送或排队PayPal 发票通过 PayPal 发送催收提醒非 PayPal 发票在老板配置的邮件应用Gmail / Apple Mail中排队为草稿未经明确批准绝不发送。第 7 步汇报结果运行结束时列出哪些已发送、哪些已排队为草稿、哪些被标记疑似已付、被排除。评分逻辑三档客户三套语气评分规则的全部细节在 tone-matching.md核心输入是QuickBooks 最近 12 个月的付款历史ScoreCriteriagood-payer≥ 75% 的发票按时或提前付款occasionally-late25–50% 的发票逾期或记录少于 3 张发票repeat-late 50% 的发票逾期两个关键约定最少 3 张发票才具备评分意义不足 3 张时默认归入occasionally-late避免仅凭一两笔交易就给客户扣上惯犯帽子按时的定义在发票到期日当天或之前收到付款。评分结果决定语气与措辞基调ScoreToneCharactergood-payerGentle温和友好假定只是疏忽。以宽容开场。occasionally-lateNeutral中性专业不做评判。事实性跟进。repeat-lateFirm强硬直接写明截止日期。无温度不指责。邮件模板主题行公式与正文结构主题行公式GentleQuick reminder: Invoice #[N] for $[amount]NeutralFollowing up: Invoice #[N] — $[amount] past dueFirmPast due notice: Invoice #[N] — $[amount] ([X] days overdue)三种主题都嵌入了发票号与金额这两个关键检索字段方便客户在邮箱里一眼定位。正文结构所有语气通用每封提醒邮件必须包含发票号、应付款总额、原始到期日、逾期天数、付款链接或付款说明。语气专属附加内容Gentle一句谅解语如 I know things get busyNeutral无——只陈述事实Firm一句截止日期语如 Please remit by [date]。以及一条硬规则每封邮件只有一个行动号召call to action绝不出现第二个。两个付款链接或两种操作方式会稀释客户的响应动作。合并规则同一客户多张逾期发票时合并为一封邮件逐张列出发票号、金额、到期日再给出合并总额。语气采用客户的整体评分而不是逾期最久那张发票的评分——这是对关系管理的刻意设计一个平时守时的客户即便有张大额发票逾期也不该收到强硬的最后通牒式措辞。两封示例邮件的实战拆解Gentle好客户 Acme Corp场景Acme Corp$1,200 发票逾期 18 天此前 5 张发票全部按时付款。评分good-payer语气 Gentle。完整模板见 examples/gentle-reminder.mdSubject: Quick reminder: Invoice #1042 for $1,200 Hi Sarah, Just a quick note — Invoice #1042 for $1,200 was due on April 9 and I havent seen payment come through yet. I know things get busy — if its already on its way, please disregard! If not, heres the link to pay online: [Pay Invoice #1042 — $1,200] Thanks so much, and let me know if anything looks off on the invoice. [Owner name]文档给出的为什么有效以假定疏忽而非指责开场给出台阶if its already on its way单一行动号召——一个付款链接短小精悍没有说教或条款声明。Firm惯犯客户 Smith LLC场景Smith LLC$450 发票逾期 47 天最近 4 张中 3 张逾期。评分repeat-late语气 Firm。完整模板见 examples/firm-reminder.mdSubject: Past due notice: Invoice #1038 — $450 (47 days overdue) Hi Tom, Invoice #1038 for $450 is now 47 days past due. The original due date was March 11. Please remit payment by May 2. You can pay online here: [Pay Invoice #1038 — $450] If theres a question about this invoice, reply to this email and Ill sort it out quickly. [Owner name]为什么有效直陈事实——金额、发票号、逾期天数、原始到期日正文中只有一个明确截止日保留专业出口if theres a question但绝不道歉单一行动号召强硬但专业——没有威胁没有全大写。两封邮件对照可以清晰看出分级策略的精髓语气强度与付款历史成反比——历史越差、语气越硬但始终守住专业、不指控、单一 CTA的共同底线。已知失败模式Gotchas六类坑位与应对gotchas.md 汇总了技能运行中已知的六类失败模式每一类都配有明确应对动作客户通过支票/银行转账付款PayPal 不可见PayPal 交叉核验只能捕获 PayPal 付款。用支票或 ACH 付款的客户仍会显示为逾期。必须在汇总表中注明 PayPal history only — check/ACH payments not verified让老板发送前确认。QuickBooks AR 含内部/测试账户过滤邮箱域名匹配老板域名的客户标记名称含 Test、Internal、Demo 的记录前文第 1 步已述。同一客户多张逾期发票——只发一封邮件同一批次绝不给同一客户起草两封提醒。全部逾期发票合并为一封列出清单与总额。两封邮件发给同一人既显混乱还可能触发垃圾邮件过滤器。客户没有 PayPal 账户导致发送失败PayPal 提醒只对拥有有效 PayPal 账户的客户生效。若 PayPal 返回发送错误降级为排队邮件草稿并汇报PayPal send failed for [customer] — queued as [mail app] draft instead. 不得静默丢弃提醒。Stripe 与 QuickBooks 可能重复承载同一张发票启用 Stripe 后同一客户可能同时出现在两套系统的逾期列表里且是同一张发票。先按发票号匹配无号可匹配时按金额 到期日匹配。不确定时标记给老板只发一封提醒而非两封。PayPal API 429 限流PayPal 的 MCP 连接器在日期窗口过宽时激进限流最常见原因是单次调用查询 14–30 天交易。修复与降级策略即第 2 步工作流中的7 天默认 → 3 天重试 → 整体跳过并标记此处不再赘述。审批门禁四条不可逾越的规则SKILL.md 将约束固化为四条审批门禁Approval gates这也是技能安全第一设计哲学的集中体现未经老板明确批准绝不发送或排队任何草稿——先展示全部草稿等待放行绝不对最近 14 天内已付款的客户发送提醒——标记为 possibly paid — verify 而非发送绝不对不在 QuickBooks AR 报表或启用的 Stripe中的客户发送——禁止仅凭记忆发送提醒任何提醒都必须有系统数据支撑一次批准只覆盖一个批次——批准后新增客户或修改草稿需开启新一轮审批。四条规则共同指向同一目标让钱的每一次动作都落在可追溯的数据与明确的授权之上。与其他技能的协同在 /plan-payroll 中承担补缺口角色invoice-chase 并非孤立技能。在 plan-payroll SKILL.md 描述的发薪保障流水线中它作为 Step 2 登场Step 1由cash-flow-snapshot产出 30/60/90 天现金预测支持--horizon与--payroll-date参数若预测显示发薪存在缺口老板批准后进入 Step 2Step 2触发 invoice-chase拉取 QuickBooks 与 PayPal 逾期发票按金额 × 逾期天数 × 客户付款历史排序为每张发票起草语气匹配的提醒PayPal 发票排队为 PayPal 发送草稿非 PayPal 发票排队为邮件草稿展示排序清单时附带若 Top-N 子集在期限内回款能否弥合 Step 1 的缺口的量化影响——这把催收从例行公事升级为有目标的补血动作两端交接处均需老板明确确认okay, see what we can collect → send these。此外技能清单small-business/README.md确认其连接器依赖必需 QuickBooks可选 PayPal、Stripe、Gmail。这意味着即使只接 QuickBooks技能也能完成拉取 AR 按 QuickBooks 历史评分 起草邮件草稿的核心链路接上 PayPal 后才具备交叉核验疑似已付与直接经 PayPal 发送的能力。使用前提与边界该技能为生成与审批流程设计不替代财务决策所有输出评分、邮件措辞、发送动作都需老板审阅确认如 small-business/README.md 所述插件不提供财务、税务、法律或人事建议。发送通道依赖已连接的工具经 PayPal 发送需要客户有 PayPal 账户邮件草稿需要 Gmail 或 Apple Mail 连接器在 Setup 阶段确认。评分数据源是 QuickBooks 最近 12 个月历史PayPal 交叉核验窗口为 7 天限流时降级 3 天这些窗口参数是技能内置约定反映了对 PayPal MCP 限流策略的实证认知。快速查阅索引技能主文档small-business/skills/invoice-chase/SKILL.md评分逻辑与语气指南small-business/skills/invoice-chase/reference/tone-matching.md已知失败模式small-business/skills/invoice-chase/reference/gotchas.md好客户温和提醒示例small-business/skills/invoice-chase/reference/examples/gentle-reminder.md惯犯客户强硬提醒示例small-business/skills/invoice-chase/reference/examples/firm-reminder.md上游协同命令 plan-payrollsmall-business/skills/plan-payroll/SKILL.md插件总览与技能清单small-business/README.md【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考