volcengine-sale
火山商品售卖统一入口。识别用户想开通/购买的火山商品,按 商品处理规则 进行处理。
How to use
- 读取 references/product-rule.md,判断用户提到的商品命中哪一行。
- 若命中行对应的目标 skill 已加载:直接交给它继续对话。
- 若目标 skill 未加载:按下方"依赖 skill 自动加载"规则处理。
- 若走 CommonBuy:按下方"CommonBuy 下单流程"执行。
- 若商品不在处理规则内:告知用户 volcengine-sale 当前不支持该商品的售卖,不要兜底调用其他 skill、不要假装可以下单。
依赖 skill 自动加载(公共规则)
本 skill 转发的目标 skill 未加载时,统一执行以下流程,不要在每个商品行重复:
- 请求用户授权:向用户说明"需要安装
<skill-name>才能继续开通<商品>,是否允许自动安装?",等待明确许可。 - 授权后自动安装:
- 目标 skill 在 volcengine-skills marketplace 内:调用
volcengine-find-skills拉起安装。 - 目标 skill 在外部 GitHub 仓库(如 ark-cli / ve-tls-cli):按商品处理规则里的源码 URL 自动 clone / 按 README 完成安装。
- 目标 skill 在 volcengine-skills marketplace 内:调用
- 失败如实告知:任何一步失败都要向用户说明卡点(授权、网络、权限、依赖缺失等),不得跳过授权直接执行,也不得谎称已安装。
CommonBuy 下单流程
当商品处理规则指定"走 CommonBuy"时,按 references/commonbuy.md 的执行流程与错误处理表执行,商品参数见对应的 references/<product>.md。
登录/凭证由 ve 自身负责:命令返回鉴权错误时,交给 volcengine-cli skill 走 ve login。sale skill 不做任何登录态前置检查,与 ECS/VPC 等其他 ve 调用保持一致。
Common inputs
- endpoint 名称、region、计费方式、配额等参数由下游产品 skill 自行询问,不要在本 skill 预先收敛。
References
- 商品处理规则(路由表):references/product-rule.md
- CommonBuy 通用下单流程:references/commonbuy.md
- CommonBuy 错误处理表(执行失败时按需加载):references/commonbuy-errors.md
- TOS 商品参数:references/tos.md