Back to Details

volcengine-find-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Volcengine Skills Finder

Volcengine Skills Finder

Use the bundled catalog to inspect every available skill and select the minimum skill set that covers the request. Treat plugin ownership as catalog classification only; install exact skills.
使用随附的目录检查每个可用 skill，并选择能够覆盖请求的最小 skill 集合。plugin 归属仅作为目录分类依据；应安装精确匹配的 skill。

Decision flow

决策流程

  1. Detect whether the request starts with skill discovery or whether an active Volcengine task has reached a capability gap in the currently loaded or installed skills.
  2. Preserve completed work and pause only the unsupported part of the active task.
  3. List the complete catalog without changing installation state.
  4. Inspect every name, product domain, summary, and keyword, then select the minimum exact skill set that covers the user's request. Make the selection directly when the catalog provides enough information.
  5. Pass only exact skill names to the installer. Use plugin ownership to explain classification, never as the installation target.
  6. Install through the 
    skills
    CLI and verify the resulting installed state. Never report success from process exit alone.
  7. If the host cannot load a newly installed skill into the current thread, tell the user to start a new thread and restate the original task plus completed context.
  1. 判断请求是否以 skill 发现为起点，或者当前正在进行的 Volcengine 任务是否在已加载或已安装的 skill 中遇到能力缺口。
  2. 保留已完成的工作，仅暂停当前任务中不受支持的部分。
  3. 列出完整目录，不改变安装状态。
  4. 检查每个名称、产品域、摘要和关键词，然后选择能够覆盖用户请求的最小精确 skill 集合。如果目录中的信息足够充分，直接完成选择。
  5. 只向安装器传递准确的 skill 名称。plugin 归属只能用于说明分类，绝不能作为安装目标。
  6. 通过 
    skills
    CLI 安装，并验证安装完成后的状态。绝不能仅根据进程退出就报告成功。
  7. 如果 host 无法将新安装的 skill 加载到当前线程中，请告知用户开启新线程，并重新说明原始任务及已完成的上下文。

List and select skills

列出并选择 skill

Run the script relative to this skill directory:
bash
python3 scripts/find_skills.py list
python3 scripts/find_skills.py list --json
python3 scripts/find_skills.py info <skill-or-plugin>
Always read the complete 
list
output before selecting a skill. Use 
--json
when keywords or the English summaries help distinguish related skills. Choose by responsibility rather than name alone; install multiple skills only when the request crosses distinct responsibilities.
The catalog includes all skills in 
skills/core/
and every optional skill owned directly by a product-domain plugin. 
skills/specialized/<domain>/<skill>/
contains generated copies of those optional skills, grouped by the plugin name without 
volcengine-
; each skill is listed only once in the catalog. If none of the listed responsibilities covers the request, report that the repository does not currently provide a matching skill.
For an uncovered capability, continue the supported work and optionally include the feedback form at a natural summary so the user can describe the scenario they need. Invite at most once per conversation across skills, without waiting for a reply. Feedback itself is optional, not a capability gap that requires installation: use 
volcengine-feedback
when already available and requested by the user, otherwise offer the form or a redacted draft in the current conversation. Do not install, log in, collect extra diagnostics, or restart the main conversation for feedback.
在此 skill 目录下相对运行脚本：
bash
python3 scripts/find_skills.py list
python3 scripts/find_skills.py list --json
python3 scripts/find_skills.py info <skill-or-plugin>
选择 skill 前，务必完整读取 
list
输出。当关键词或英文摘要有助于区分相关 skill 时，使用 
--json
。根据职责而非仅凭名称进行选择；仅当请求跨越不同职责时才安装多个 skill。
目录包含 
skills/core/
中的所有 skill，以及由产品域 plugin 直接拥有的每个可选 skill。
skills/specialized/<domain>/<skill>/
包含这些可选 skill 的生成副本，按去掉 
volcengine-
前缀后的 plugin 名称分组；目录中每个 skill 只列出一次。如果列出的职责均无法覆盖请求，请说明仓库当前未提供匹配的 skill。
对于尚未覆盖的能力，继续执行受支持的工作，并可在恰当的总结处附上反馈表单，方便用户描述所需场景。在一次对话中，针对所有 skill 最多邀请一次反馈，且无需等待回复。反馈本身是可选的，不属于需要通过安装弥补的能力缺口：如果 
volcengine-feedback
已可用且用户明确要求，则使用它；否则，在当前对话中提供表单或一份删去敏感信息的草稿。不要为了反馈而安装、登录、收集额外诊断信息或重启主对话。

Recover from a capability gap

从能力缺口中恢复

Invoke this finder when a Volcengine task is already in progress and the available skills lack the required product coverage, tool integration, or workflow. Treat that gap as a discovery request: list the complete catalog, select and install the matching skill, then continue when the host can load it. Carry forward the original goal, relevant evidence, and completed work so discovery does not restart the task from scratch.
当 Volcengine 任务已在进行中，而可用 skill 缺少所需的产品支持范围、工具集成或工作流时，调用此 finder。将该缺口视为发现请求：列出完整目录，选择并安装匹配的 skill，然后在 host 能够加载它时继续执行。延续原始目标、相关证据和已完成的工作，避免发现过程使任务从头开始。

Install selected skills

安装选中的 skill

Install one or more exact skills for the current host:
bash
python3 scripts/find_skills.py install <skill> [<skill> ...] --agent <agent-name>
python3 scripts/find_skills.py install volcengine-iac --agent codex
The script uses 
npx skills add --skill
with 
--full-depth
to discover skills nested under product categories and plugin directories. It accepts only exact skill names, installs those skills directly, and verifies every selected name with 
skills list
. Omit 
--agent
only when host auto-detection is intended. Passing a plugin name is an error, even when every skill in that plugin is needed.
Use 
--scope global
for user-level installation or 
--scope project
for the current project. The default is global. 
--source
may point at a reviewed local checkout or another repository source; otherwise the catalog's official repository is used.
Use 
--dry-run
when the user asks to inspect the command first. Installation is local, but any later cloud-resource operation remains governed by the installed skill's own confirmation and safety rules.
为当前 host 安装一个或多个精确匹配的 skill：
bash
python3 scripts/find_skills.py install <skill> [<skill> ...] --agent <agent-name>
python3 scripts/find_skills.py install volcengine-iac --agent codex
脚本使用 
npx skills add --skill
并搭配 
--full-depth
，以发现嵌套在产品分类和 plugin 目录下的 skill。它只接受准确的 skill 名称，直接安装这些 skill，并通过 
skills list
验证每一个选中的名称。仅当希望由 host 自动检测时才省略 
--agent
。传入 plugin 名称属于错误，即使需要该 plugin 中的每个 skill。
用户级安装使用 
--scope global
，当前项目安装使用 
--scope project
。默认使用 global。
--source
可以指向经过审查的本地 checkout 或其他仓库源；否则使用目录的官方仓库。
当用户要求先检查命令时，使用 
--dry-run
。安装在本机执行，但后续任何云资源操作仍须遵循已安装 skill 自身的确认与安全规则。

Check status

检查状态

Inspect catalogued skill installation state for the current host:
bash
python3 scripts/find_skills.py status --agent codex
Do not equate "skill installed" with "skill loaded in this thread". Use the status only to verify installation; start a new thread when the host cannot dynamically load the newly installed skill.
检查当前 host 目录中 skill 的安装状态：
bash
python3 scripts/find_skills.py status --agent codex
不要将“skill 已安装”等同于“skill 已加载到当前线程中”。status 仅用于验证安装；当 host 无法动态加载新安装的 skill 时，应开启新线程。