关于 billing-behaviors
为计费系统集成提供行为规则的 Skill,面向使用计费 API 和 SDK 的开发者。它要求先查阅对应版本的参考资料,按具体操作核实计费行为,并为影响计费资源的操作设定保护条件。
主要功能
- 01命名 API 前解析 SDK 参考资料
- 02按计费主题选择行为指南
- 03核实续订任务的发现规则
- 04变更计费前要求明确上下文
- 05仅在获准时执行线上操作
适用场景
- 01集成 SDK 时核对计费行为
- 02为计费变更选择适用参考资料
- 03验证续订资格判断逻辑
- 04保护沙箱与线上计费操作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ commet-labs/ skills --skill billing-behaviors安装后在 Claude Code 中输入/billing-behaviors确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/billing-and-dunning.mdcatalog-pricing-and-offers.mdsubscriptions-and-plan-changes.mdusage-balances-and-seats.md详细介绍
计费行为规则
区分精确的 API 结构与计费行为:
- 在命名方法、字段、错误、事件或版本之前,先解析已安装 SDK 的
docs/manifest.json、入口点、生成的参考文档以及相关 Platform 文档。 - 对于生成的类型无法表达的行为策略,请使用本技能中的参考文档。
- 如果当前产品代码可用,其服务路径和针对性测试的证据优先级高于本技能。
在 Node 项目中进行集成更改之前,运行 commet doctor --output agent,并解决文档、兼容性、API 版本或项目上下文检查失败的问题。
选择相关的行为参考文档
- subscriptions-and-plan-changes.md — 生命周期、访问权限、体验资格、变更、取消和重新激活。
- billing-and-dunning.md — 计费周期、发票构成、折扣和重试计划。
- usage-balances-and-seats.md — 用量模型、重置、用量包、充值、配额和席位补差计费。
- catalog-pricing-and-offers.md — 方案、货币定价、Markets、可选变体、Offers、促销码、附加项和归档行为。
不要根据笼统的公平原则口号推断行为。计划安排、收费、折扣、重试和重置都由具体操作明确规定。对于续订时间,请核实当前的发现条件;切勿根据仅显示日期的仪表板值、旧版计费日列或 cron 计划推断订阅已到期应续订。
防范副作用
推理、代码编辑和本地测试无需远程上下文。在创建或更改计费资源、发票、订阅、余额、用量、额度或重试之前,明确说明具体组织以及 sandbox 或 live 模式。在 Node 项目中,使用通过检查的 PROJECT_CONTEXT_VALID doctor 检查结果;否则要求提供明确的项目或用户上下文。除非用户的请求明确授权,否则不得执行会影响实时计费的操作。
评论
支持 Markdown