用途
billing-setup 用于帮助用户在 Credyt 中完成计费体系的搭建。它先引导用户理解自己的计费模型，然后通过 MCP 工具在 Credyt 中配置产品、资产与定价，最后自动端到端验证完整计费周期。该技能可以多次运行，用于新增产品、调整定价或设置更多资产。
主要能力
- 检查现有配置：通过 credyt:list_assets 和 credyt:list_products 查看当前状态，若已有产品则询问用户是要新增、修改定价还是重新开始。重新开始时不会归档或删除已有产品，用户可随时通过对话管理现有产品。
- 业务发现：以对话方式逐个提问，了解应用做什么、哪些活动产生成本、希望如何收费、使用美元还是自定义货币、定价是否随维度变化。
- 计费方式选择：支持三种方式——预付费钱包（按量付费）、月度订阅、混合模式（订阅加积分）。若用户不确定定价，可先追踪活动与成本，之后再定价。
- 货币选择：支持美元或自定义货币（积分、代币等）。积分适合成本多变、用户非技术型、希望用户赚取积分或未来可能调整定价的场景；美元适合每次活动成本固定、用户是开发者、追求完全透明的场景。
- 配置自定义货币：使用 credyt:create_asset 创建，需明确确认精度（积分通常为整数，精度 0）与兑换率，并用 credyt:quote_asset 验证兑换，必要时用 credyt:add_asset_rate 修正。
- 创建产品与定价：使用 credyt:create_product 为每个计费活动创建产品，需确认产品名称与代码、事件类型、用量类型（按次或按量）、定价。支持先追踪后定价（价格设为零）。一个产品可同时有固定周期价格和基于用量的实时价格。
- 更新定价：始终使用 credyt:create_product_version 创建新版本，而非新建产品，以保留计费历史。
- 验证：创建或更新产品后使用 credyt:simulate_usage 验证，需显式指定产品版本。若模拟不符，创建新版本并重新模拟。
- 订阅内包含积分（entitlements）：在产品层面配置，支持定期刷新（如每月 1000 积分）和一次性发放（如注册奖励）。不可用负价格建模。
- 成本追踪：可选创建供应商（credyt:create_vendor），在发送用量事件时附带 costs 数组，Credyt 自动计算利润。
- 端到端验证：配置完成后自动运行完整计费周期测试，对每个新建或修改的产品执行六步验证流程，失败则协助修复并重跑。
使用方式
该技能通过 MCP 工具与 Credyt 交互。每次创建或修改数据前，会向用户展示参数表并请求明确确认，尤其针对精度、定价和事件类型。配置完成后，技能会总结已创建和验证的内容，并建议下一步运行 /credyt:billing-integration 将计费接入应用，或再次运行 /credyt:billing-setup 添加更多产品。
适用场景
- 首次在 Credyt 中搭建计费体系。
- 为已有应用新增计费产品。
- 调整现有产品定价。
- 设置订阅内包含的积分或一次性促销积分。
- 追踪各活动的成本以查看利润率。
限制
该技能只配置产品与定价，不编写集成代码。SDK 形态、端点和认证头容易猜错，因此集成需使用 billing-integration 技能。若该技能未安装，需请用户运行 npx skills add credyt/ai-tools 后再运行。从应用代码调用 Credyt API 的首选方式是官方 SDK：@credyt/api-client（TypeScript/Node.js）或 credyt-api（Python）；若均不适用，billing-integration 技能也涵盖 HTTP 直接调用。