技能介绍

要解决的问题

当你对着火山引擎控制台，知道要调哪个 API，却懒得翻文档、猜参数、配环境时——需要一个能听懂自然语言请求、自动定位 API、生成可直接运行 SDK 代码的工具。手动写示例代码的麻烦在于：API 列表太长，参数层级复杂，Swagger 里的 example 还得自己抠，而且不同语言的代码模板也不统一。

核心能力与工作流程

这个技能把「从一句话到可运行代码」拆成了几个步骤：

API 定位：用 scripts/rg_rank.py 对本地 API 索引做排序，先尝试 rg 加速扫描，不可用时回退到纯 Python 实现。它会通过关键词推断、别名匹配、OR 召回和字段加权打分来容忍用户请求中的噪声。如果本地完全没有命中，会自动回退到 API Explorer 的远程搜索，并把结果标记为 remote_search。
参数补全：当用户没给全必需参数时，从 Swagger 元数据里按 example → examples → default → enum → 类型约束的优先级生成 mock 值，并用中文注释标注在赋值行附近。只补顶层必需字段，递归时也只补必需子字段，可选参数一律不碰。
代码生成：调用 scripts/make_code.py 以直接模式产出 Python、Go、Java、PHP 的示例代码，涵盖认证配置、请求对象构造、调用和响应打印。生成的代码就是最终交付物，不会被重写成自定义工具。

适用边界

默认输出只聚焦 API 调用本身，不会自动加上重试、代理、连接池或调试日志这类高级配置。需要这些内容时，技能会查 references/ 下对应的语言集成文档。SDK 安装命令只在用户明确问「怎么装」「用哪个版本」时才通过 sdk_info.py 拉取，正常生成代码时不会触发。此外，纯泛化查询（如只有 api、sdk 这类词）会被跳过本地匹配，需要用户补充具体资源或操作词才能得到有效结果。