SuperAPI AI 工具集

billing-review

通用与其它

查看项目

更新于 10-16 03:44

技能介绍

用途:Billing Review 是 Polar 计费领域的专项评审清单,针对触及订阅、周期与 cron、订单、计费条目、计量与用量、折扣、结账、付款、退款、争议、税务等模块的 diff,检查是否破坏团队执行的计费不变量。它不是通用代码审查,其他视角负责 Polar 的约定、契约和部署形态。

主要能力:规则源自 François(frankie567)在 2026 年 2 月至 8 月计费 PR 上的约 210 条评审意见,以及 pieterbeulque、psincraian、joebon、Yopi 提出的领域不变量,每条规则标注对应 PR。检查项包括:金额必须来自计费条目(BillingEntry)而非派生状态;复用周期生命周期而非手写状态转换;重试决策放在 dunning 入口 _handle_first_dunning_attempt;付款锁只在一个路径释放(handle_payment_failure),成功时不得释放;保持处理器状态同步且处理器名称不进入领域;cron 与批处理避免 catch-up 循环和全表加载,使用 repository.stream;折扣的赎回计数、并发锁、max_redemptions 与 max_redemptions_per_customer、过期检查和多行折扣瀑布分配;金额、币种与税务的单位(基点)和来源;免费与零金额路径;以及归属其他视角的计费特有补充(大表回填用脚本、并发建索引、外键 ondelete="restrict"、惰性加载等)。

使用方式:先阅读 .agents/skills/polar-billing.md 了解领域地图,再按本清单逐项核对 diff;无法从 diff 判断的领域问题应提问而非断言缺陷。输出格式为 Billing 段落,分 Blocking、Should fix、Question、Notes 与 Verdict。

适用场景:Polar 仓库中涉及上述路径与模型的改动评审。

限制:范围限于清单列出的目录、文件与迁移脚本;模式与 SDK 影响、迁移与部署安全、约定、ADR、复用分别归其他视角处理;具体安装命令、价格与收费方式暂未提供。