volcengine-find-skills

Volcengine 技能查找器

使用随附的目录检查所有可用技能，并选择能够覆盖请求的最小技能集。仅将插件归属视为目录分类；安装时使用确切的技能名称。

决策流程

1. 判断请求是否以技能发现为起点，或当前 Volcengine 任务是否因已加载或已安装的技能无法满足某项能力而遇到瓶颈。
2. 保留已完成的工作，仅暂停当前任务中不受支持的部分。
3. 列出完整目录，不更改安装状态。
4. 检查每个名称、产品领域、摘要和关键词，然后选择能够覆盖用户请求的最小确切技能集。若目录提供的信息足够，请直接作出选择。
5. 仅向安装程序传递确切的技能名称。使用插件归属解释分类，绝不将其作为安装目标。
6. 通过 skills CLI 安装，并验证安装后的状态。绝不能仅凭进程退出就报告成功。
7. 如果宿主无法在当前会话中加载新安装的技能，请告知用户开启新会话，并重新说明原始任务和已完成的上下文。

列出并选择技能

相对于此技能目录运行脚本：

python3 scripts/find_skills.py list
python3 scripts/find_skills.py list --json
python3 scripts/find_skills.py info <skill-or-plugin>

选择技能前，务必先阅读完整的 list 输出。如果关键词或英文摘要有助于区分相关技能，请使用 --json。应根据职责而非仅凭名称选择；只有当请求涉及不同职责时，才安装多个技能。

目录包含 skills/core/ 中的所有技能，以及由产品领域插件直接拥有的所有可选技能。skills/specialized/<domain>/<skill>/ 包含这些可选技能的生成副本，并按去掉 volcengine- 的插件名称分组；目录中每个技能只列出一次。如果列出的职责均无法覆盖请求，请说明该仓库目前没有提供匹配的技能。

对于未覆盖的能力，请继续完成受支持的工作，并可在总结的自然位置添加反馈表单，让用户描述所需的场景。在一段对话中，跨所有技能最多邀请一次，且无需等待回复。反馈本身是可选的，并非需要安装技能才能解决的能力缺口：如果用户请求反馈且 volcengine-feedback 已可用，请使用它；否则，提供表单或在当前对话中起草经过脱敏的反馈。不要为了反馈而安装技能、登录、收集额外诊断信息或重启主对话。

从能力缺口中恢复

如果 Volcengine 任务已在进行中，但可用技能缺少所需的产品覆盖、工具集成或工作流，请调用此查找器。将此缺口视为技能发现请求：列出完整目录，选择并安装匹配的技能，然后在宿主能够加载该技能时继续。保留原始目标、相关证据和已完成的工作，避免技能发现导致任务从头开始。

安装选定的技能

为当前主机安装一个或多个指定技能：

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，以发现嵌套在产品类别和插件目录中的技能。它只接受确切的技能名称，直接安装这些技能，并使用 skills list 验证每个选定的名称。仅当需要自动检测主机时，才省略 --agent。 即使需要某个插件中的所有技能，传入插件名称也会导致错误。

使用 --scope global 进行用户级安装，或使用 --scope project 安装到当前项目。默认值为 global。--source 可以指向经过审核的本地检出版本或其他仓库源；否则将使用目录的官方仓库。

用户要求先检查命令时，使用 --dry-run。安装在本地进行，但之后任何云资源操作仍受已安装技能自身的确认与安全规则约束。

检查状态

检查当前主机上目录中技能的安装状态：

python3 scripts/find_skills.py status --agent codex

不要将“技能已安装”等同于“技能已在此线程中加载”。状态仅用于验证安装；如果主机无法动态加载新安装的技能，请启动新线程。