{
  "markdown": "# volcengine-skills\n\n---\n[![Volcengine SKILL & CLI Survey](img_new.png)](https://www.volcengine.com/survey/q/v2/7662656599489085475/q36U8r81/5ffc/channel=doc)\n\n为提高您对火山引擎 skill 的使用体验，邀您参加[有奖调研](https://www.volcengine.com/survey/q/v2/7662656599489085475/q36U8r81/5ffc/channel=doc)。\n\n---\n\n[English](./README_en.md) | **简体中文**\n\n火山引擎团队维护的 skill marketplace，面向 Claude Code / Codex / OpenCode / Cursor / Gemini CLI\n等 AI coding agent。仓库默认只安装核心插件；其他技能按火山引擎产品域拆分为可选插件，由\n`volcengine-find-skills` 统一发现和安装。\n\n**[快速安装 →](#默认安装)**\n\n## Plugins\n\n| Plugin | 产品分类 | Skills | 默认安装 |\n| --- | --- | --- | --- |\n| `volcengine-core` | 核心 | `volcengine-cli`、`volcengine-troubleshooting`、`volcengine-knowledge-search`、`volcengine-find-skills` | 是 |\n| `volcengine-storage` | 存储 | `volcengine-tosutil` | 否 |\n| `volcengine-database` | 数据库 | `volcengine-db-supabase` | 否 |\n| `volcengine-containers-middleware` | 容器与中间件 | `volcengine-vefaas` | 否 |\n| `volcengine-security` | 安全 | `volcengine-compliance` | 否 |\n| `volcengine-identity-access-control` | 身份与访问控制 | `volcengine-landing-zone` | 否 |\n| `volcengine-service-support` | 服务支持 | `volcengine-sale`、`volcengine-prepare`、`volcengine-deploy`、`volcengine-iac`、`volcengine-api`、`volcengine-sdk-generator` | 否 |\n\n核心插件的 marketplace 策略为 `INSTALLED_BY_DEFAULT`，其他插件均为 `AVAILABLE`。\n`skills/` 下只保留 `core/` 分类；发布工具会自动发现其中的核心 skill。其他 skill 由各自的可选 plugin 直接拥有，不在 `skills/` 下保留副本。\n\n## Skills\n\n| Skill | Plugin | 场景 |\n| --- | --- | --- |\n| [`volcengine-cli`](./skills/core/volcengine-cli/SKILL.md) | `volcengine-core` | 用 `ve` CLI 创建、查询和管理云资源 |\n| [`volcengine-troubleshooting`](./skills/core/volcengine-troubleshooting/SKILL.md) | `volcengine-core` | 火山引擎故障排查与诊断 |\n| [`volcengine-knowledge-search`](./skills/core/volcengine-knowledge-search/SKILL.md) | `volcengine-core` | 检索火山引擎官方文档并获取全文 |\n| [`volcengine-find-skills`](./skills/core/volcengine-find-skills/SKILL.md) | `volcengine-core` | 列出全部 skill，供 Agent 选择并安装 |\n| [`volcengine-sale`](./plugins/volcengine-service-support/skills/volcengine-sale/SKILL.md) | `volcengine-service-support` | 火山引擎商品售卖 |\n| [`volcengine-prepare`](./plugins/volcengine-service-support/skills/volcengine-prepare/SKILL.md) | `volcengine-service-support` | 分析仓库并推荐 ECS / VKE / veFaaS 部署形态 |\n| [`volcengine-deploy`](./plugins/volcengine-service-support/skills/volcengine-deploy/SKILL.md) | `volcengine-service-support` | 将本地目录或 Git 仓库部署到火山引擎 |\n| [`volcengine-iac`](./plugins/volcengine-service-support/skills/volcengine-iac/SKILL.md) | `volcengine-service-support` | 使用 Terraform 编排火山引擎基础设施 |\n| [`volcengine-tosutil`](./plugins/volcengine-storage/skills/volcengine-tosutil/SKILL.md) | `volcengine-storage` | 管理 TOS 对象存储资源 |\n| [`volcengine-db-supabase`](./plugins/volcengine-database/skills/volcengine-db-supabase/SKILL.md) | `volcengine-database` | 管理 AI 原生 BaaS 平台 Supabase 版（AIDAP） |\n| [`volcengine-vefaas`](./plugins/volcengine-containers-middleware/skills/volcengine-vefaas/SKILL.md) | `volcengine-containers-middleware` | 部署和管理 veFaaS Serverless 应用 |\n| [`volcengine-compliance`](./plugins/volcengine-security/skills/volcengine-compliance/SKILL.md) | `volcengine-security` | 推荐合规基线、汇总态势并编写自定义规则 |\n| [`volcengine-landing-zone`](./plugins/volcengine-identity-access-control/skills/volcengine-landing-zone/SKILL.md) | `volcengine-identity-access-control` | Landing Zone、账号工厂与治理基线 |\n| [`volcengine-api`](./plugins/volcengine-service-support/skills/volcengine-api/SKILL.md) | `volcengine-service-support` | 查询 API 参数、错误码和返回结构 |\n| [`volcengine-sdk-generator`](./plugins/volcengine-service-support/skills/volcengine-sdk-generator/SKILL.md) | `volcengine-service-support` | 生成可运行的多语言 SDK 示例 |\n\n## 默认安装\n\n### Finder 设计\n\n`volcengine-find-skills` 内置唯一 catalog，覆盖全部 core skill 和所有可选 plugin skill：\n\n1. 用户主动查找 skill，或者执行火山引擎任务时当前已加载/已安装 skill 无法覆盖所需产品、工具或流程，都会触发 finder。\n2. `list` 一次列出完整 catalog，由 Agent 根据名称、产品域、摘要和关键词选择最小必要 skill 集合。\n3. 安装前必须解析为精确的 skill 名称；plugin 只用于分类，不能作为安装目标。\n4. finder 对所有宿主都通过 skills CLI 直接安装选中的 skill，不安装整个 plugin。\n5. 安装命令成功后再次读取宿主安装清单，只有目标全部可见才返回 `verified: true`。\n6. 新增 skill 安装后，若宿主不能动态加载，则新开对话并携带原任务和已完成上下文继续执行。\n\n### Codex\n\n添加 marketplace 后只安装核心插件：\n\n```bash\ncodex plugin marketplace add volcengine/volcengine-skills\ncodex plugin add volcengine-core@volcengine-skills\ncodex plugin list\n```\n\n上述 plugin 命令只用于首次加载核心 finder。finder 后续发现缺失能力时，只直接安装选中的 skill。\n\n在新对话中直接描述需求，例如“查找对象存储相关 skill”或“安装 `volcengine-tosutil`”。finder 会读取\n完整 catalog、自主选择并直接安装合适的 skill，不会安装整个产品域 plugin。若当前对话不能动态加载新增 skill，需新开对话继续。\n\n在源码仓库内也可以直接验证发现结果：\n\n```bash\npython3 plugins/volcengine-core/skills/volcengine-find-skills/scripts/find_skills.py list\npython3 plugins/volcengine-core/skills/volcengine-find-skills/scripts/find_skills.py install volcengine-tosutil --agent codex\npython3 plugins/volcengine-core/skills/volcengine-find-skills/scripts/find_skills.py status --agent codex\n```\n\n### 通用 skills CLI\n\n下面的命令只安装当前核心 skill，不会默认安装可选产品域 skill：\n\n```bash\nnpx skills add volcengine/volcengine-skills \\\n  --global --yes --copy --full-depth \\\n  --skill volcengine-cli volcengine-troubleshooting volcengine-knowledge-search volcengine-find-skills\n```\n\n后续可由 finder 调用 `npx skills add --skill` 精确安装单个或多个 skill。如需一次安装 catalog 中的全部 skill：\n\n```bash\nnpx skills add volcengine/volcengine-skills --full-depth\n```\n\n### Claude Code\n\n```text\n/plugin marketplace add volcengine/volcengine-skills\n/plugin install volcengine-core@volcengine-skills\n/reload-plugins\n/volcengine-core:volcengine-find-skills\n```\n\n### Gemini CLI\n\n```bash\ngemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-cli\ngemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-troubleshooting\ngemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-knowledge-search\ngemini skills install https://github.com/volcengine/volcengine-skills --path skills/core/volcengine-find-skills\ngemini skills list\n```\n\n首次安装时逐项确认安全提示。安装后重新启动 Gemini CLI；可直接描述火山引擎任务，也可要求它使用 `volcengine-find-skills`。\n\n### OpenCode\n\n按 [OpenCode 安装说明](./.opencode/INSTALL.md) 挂载核心插件的 `skills/` 目录。\n\n### Cursor\n\n```text\n/add-plugin volcengine-core@https://github.com/volcengine/volcengine-skills\n/volcengine-find-skills\n```\n\n在 Cursor 2.5 或更高版本的 Agent 对话中输入完整命令；`/add-plugin` 可能不会出现在自动补全中。\n\n## 目录结构\n\n```text\nvolcengine-skills/\n├── skills/\n│   └── core/                         # CLI 默认安装的核心 skill\n├── plugins/\n│   ├── volcengine-core/              # 默认核心 plugin，复制 skills/core 并保留 hooks\n│   └── volcengine-<domain>/          # 可选 plugin，也是其 skill 的唯一源码\n└── .agents/plugins/marketplace.json\n```\n\n`skills/core/` 是核心 skill 的规范源码；可选 skill 直接在所属 plugin 中维护。同步脚本只复制 core、生成 manifest 和 marketplace。修改或新增 skill 后运行：\n\n```bash\npython3 scripts/sync_plugins.py\npython3 scripts/validate_codex_plugin_layout.py\npython3 -m unittest discover -s tests -v\n```\n\n## License\n\nMIT，见 [LICENSE](./LICENSE)。\n",
  "bytes": 6842,
  "sha": "815c1a461a1b3ae4c4509c8ff38379627c4b9e6fc2234be1d4a09b4f96a8e35d",
  "repo_slug": "volcengine/volcengine-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_volcengine_volcengine_skills_eb62870e/readme"
}