# Volcengine Sale

> Use when the user asks to purchase, subscribe, provision, open, or place an order for any Volcengine commercial product, or uses Chinese verbs such as "开通 / 购买 / 下单 / 买 / 售卖 / 想买 / 订购" together with a Volcengine product name. Trigger even when the user does not mention "sale" but expresses a clear provisioning intent.

- Skill: `volcengine/volcengine-sale` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add volcengine/volcengine-sale`
- Raw SKILL.md: https://api.skillmd.com/api/skills/volcengine/volcengine-sale/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: volcengine (https://skillmd.com/u/volcengine)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/volcengine/volcengine-sale

---


# volcengine-sale

火山商品售卖统一入口。识别用户想开通/购买的火山商品，按 [商品处理规则](./references/product-rule.md) 进行处理。

## How to use

1. 读取 [references/product-rule.md](./references/product-rule.md)，判断用户提到的商品命中哪一行。
2. 若命中行对应的目标 skill 已加载：直接交给它继续对话。
3. 若目标 skill 未加载：按下方"依赖 skill 自动加载"规则处理。
4. 若走 CommonBuy：按下方"CommonBuy 下单流程"执行。
5. 若商品不在处理规则内：告知用户 volcengine-sale 当前不支持该商品的售卖，不要兜底调用其他 skill、不要假装可以下单。

## 依赖 skill 自动加载（公共规则）

本 skill 转发的目标 skill 未加载时，统一执行以下流程，不要在每个商品行重复：

1. **请求用户授权**：向用户说明"需要安装 `<skill-name>` 才能继续开通 `<商品>`，是否允许自动安装？"，等待明确许可。
2. **授权后自动安装**：
   - 目标 skill 在 volcengine-skills marketplace 内：调用 `volcengine-find-skills` 拉起安装。
   - 目标 skill 在外部 GitHub 仓库（如 ark-cli / ve-tls-cli）：按商品处理规则里的源码 URL 自动 clone / 按 README 完成安装。
3. **失败如实告知**：任何一步失败都要向用户说明卡点（授权、网络、权限、依赖缺失等），不得跳过授权直接执行，也不得谎称已安装。

## CommonBuy 下单流程

当商品处理规则指定"走 CommonBuy"时，按 [references/commonbuy.md](./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](./references/product-rule.md)
- CommonBuy 通用下单流程：[references/commonbuy.md](./references/commonbuy.md)
- CommonBuy 错误处理表（执行失败时按需加载）：[references/commonbuy-errors.md](./references/commonbuy-errors.md)
- TOS 商品参数：[references/tos.md](./references/tos.md)