火山引擎技能查找器用于在 volcengine-skills 技能市场中定位并安装火山引擎技能。它适用于两类场景：用户一开始就询问某项任务由哪个火山引擎技能或插件负责；或某项火山引擎任务进行中，当前已加载或已安装的技能缺少所需的产品覆盖、工具集成或工作流。
主要能力
- 列出完整技能目录：运行 python3 scripts/find_skills.py list，或用 list --json 获取带英文摘要与关键词的 JSON 输出。目录涵盖 skills/core/ 下的全部技能，以及各产品域插件直接拥有的可选技能；skills/specialized/<domain>/<skill>/ 是可选技能按插件名（去掉 volcengine- 前缀）分组的生成副本，每个技能在目录中只出现一次。
- 查看技能详情：python3 scripts/find_skills.py info <skill-or-plugin>。
- 安装指定技能：python3 scripts/find_skills.py install <skill> [<skill> ...] --agent <agent-name>，例如 install volcengine-iac --agent codex。脚本通过 npx skills add --skill 并带 --full-depth 发现嵌套在产品分类与插件目录下的技能，只接受精确技能名并直接安装，随后用 skills list 逐个核验；传入插件名会报错。可用 --scope global（用户级，默认）或 --scope project（当前项目）；--source 可指向经过审查的本地检出或其他仓库来源，否则使用目录的官方仓库；--dry-run 用于先查看将执行的命令。
- 检查安装状态：python3 scripts/find_skills.py status --agent codex。
使用方式 先读取完整列表输出，再依据技能职责而非名称选择能覆盖用户请求的最小精确技能集合；仅当请求跨越不同职责时才安装多个技能。目录信息足够时可直接选定。插件归属只用于解释分类，不作为安装目标。安装后需核验实际安装状态，不能仅凭进程退出码报告成功。若宿主无法把新安装技能加载到当前线程，应提示用户新开线程，并重述原任务与已完成上下文。
能力缺口处理 当进行中的火山引擎任务遇到能力缺口时，将其视为一次发现请求：列出完整目录、选择并安装匹配技能，宿主能加载后继续原任务，并保留原目标、相关证据与已完成工作，避免任务从头重来。若目录中没有任何职责覆盖该请求，应说明仓库当前未提供匹配技能；可在自然总结处至多一次附上反馈表单让用户描述场景，不等待回复。反馈是可选项，不构成需安装的能力缺口：若 volcengine-feedback 已可用且用户要求则使用，否则在当前对话中提供表单或脱敏草稿；不要为反馈而安装、登录、额外收集诊断信息或重启主对话。
限制 安装为本地操作，但后续任何云资源操作仍受所安装技能自身的确认与安全规则约束；该技能本身不提供云资源操作能力。未在资料中说明定价、平台兼容范围或效果指标，暂未提供。