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

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