文档中心

火山引擎 Skills

常见问题

以下问题覆盖 Volcengine Skills 的能力组成、安装发现、身份执行和数据反馈。遇到具体错误时，请根据问题类型进入对应的安装、Skill 或故障诊断文档。

产品与能力

Volcengine Skills、Plugin 和 CLI 有什么区别？

Skill 为 Agent 提供任务说明、参考资料和必要脚本；Plugin 用于组织和分发一组 Skills；CLI 负责执行具体命令或调用云 API。安装 Plugin 后，Agent 根据任务加载 Skill，再由 Skill 选择合适的 CLI 或 API 完成操作。

详细说明：组件与工作方式

每个云产品都有独立 Skill 吗？

不是。文档检索、云资源操作、故障诊断和 Skill 发现属于通用核心能力；只有已经进入公开 Catalog 的产品或专业工作流，才提供对应的专用 Skill。需要某项能力时，可以让 Agent 使用 volcengine-find-skills 查询。

查看已发布能力：Skills 与能力目录

安装与发现

应该选择哪种安装方式？

希望快速完成基础配置时使用一键安装；希望使用 Agent 自带的 Plugin 管理能力时选择原生 Plugin；需要指定 Agent 或精确选择 Skill 时使用通用 Skills CLI。三种方式都可以获得核心 Skills。

一键安装会安装哪些内容？

一键安装会准备四个核心 Skills，并检查 ve 和 arkcli 是否可用。其他产品领域的 Skills 根据任务由 volcengine-find-skills 或通用 Skills CLI 按需安装。

安装 Skills 后，是否已经安装所有云产品 CLI？

没有。一键安装只检查并按需安装 ve 和 arkcli。tosutil、vefaas 等产品工具由对应 Skill 在任务需要时检查和准备。

安装时需要填写 AK/SK 吗？

不需要。安装过程不收集云账号凭据。查询公开文档也不需要登录；只有访问或修改云资源时，才需要按照对应 Skill 的提示完成登录或授权。

支持哪些 Agent？

当前文档提供 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 和 OpenClaw 的安装说明。其他兼容 Skills 的 Agent 可以使用通用 Skills CLI 安装，但具体加载方式以对应 Agent 的能力为准。

安装方式和兼容性：安装与配置

安装后 Agent 找不到 Skill 怎么办？

重启 Agent、重新加载 Plugin，或新建任务。

查看 Agent 的 Skills 或 Plugin 列表，确认核心 Skills 已安装。

调用 volcengine-find-skills，确认能够读取 Skills Catalog。

仍无法发现时，按照对应 Agent 的安装方式重新验证安装范围和路径。

Finder 显示安装成功，为什么当前任务仍不能使用新 Skill？

部分 Agent 不能在当前任务中动态加载新 Skill。Finder 确认安装成功后，如果新能力仍不可用，请新建任务，并携带原任务目标和已经完成的上下文继续。

可选能力应该按 Skill 名还是 Plugin 名安装？

按具体 Skill 名安装。Plugin 用于能力分类和发布，不是 Finder 的按需安装目标。让 Agent 先查询 Catalog，再选择最小必要的 Skill 集合。

身份与执行

ve 命令不存在怎么办？

先确认是否使用一键安装，并运行 command -v ve。如果没有返回可执行文件路径，请检查 npm 全局安装目录是否在 PATH 中，或按照安装文档重新准备 ve。

ve 已安装，但云账号身份不可用怎么办？

运行 ve sts GetCallerIdentity，同时检查业务返回中是否包含 ResponseMetadata.Error。身份无效时，根据实际环境重新完成 Console Login、AK/SK、STS 或 SSO 配置，并确认 Profile 和 Region 一致。

Agent 执行云资源变更前会要求确认吗？

只读查询可以在确认无副作用后直接执行。创建、修改和部署等写操作应先展示目标、参数和影响，并等待确认；删除资源等破坏性操作需要明确说明不可逆影响，高风险操作按照对应 Skill 的要求再次确认。

凭据、确认和数据处理说明：安全与数据

数据与反馈

Telemetry 会收集哪些信息？

核心 Plugin 的 Telemetry 用于记录 Skill 加载事件，包括 Agent、Skill、工具和包版本等低敏信息；不会采集文件内容、命令参数值、AK/SK、Token、会话记录或当前工作目录。Telemetry 不能判断任务是否完成或结果是否正确。

如需关闭，请设置环境变量并重新启动 Agent：

export VOLCENGINE_TELEMETRY_DISABLED=1

反馈问题时需要提供哪些信息？

请提供脱敏后的 Agent 与版本、安装方式、Skill 名称、退出码、ErrorCode、RequestId、Action 和 Region。安全漏洞、凭据泄露或隐私问题不要提交到公开 Issue，请使用仓库 SECURITY.md 中的安全渠道。

反馈入口：支持与版本

最近更新时间：2026.08.25 21:41:28

这个页面对您有帮助吗？

有用

无用