用途:根据 API 文档创建一个新的 Bruno API 端点请求文件。它会先从对话上下文推断目标 API 与操作;若不清楚,会询问应为哪个 API 和端点创建 Bruno 请求。
主要能力:使用 WebFetch(或 context7)获取 API 文档,提取端点路径、HTTP 方法、必需请求头、请求体 schema 和认证类型;查找项目中已有的 Bruno .bru 请求文件并阅读若干份,以了解本地约定,例如变量命名、认证风格和 seq 编号;按资源分组,使 bruno/api/ 下的目录树镜像端点 URL 路径,并将文件命名为 <verb>-<noun>.bru,例如 POST /api/webhook/orders 对应 bruno/api/webhook/create-order.bru;调用 /bruno 技能创建 .bru 文件,并在请求体中填入贴近实际的占位值。
使用方式:在对话中说明要创建的 API 端点,或让技能根据上下文推断;技能会抓取文档、参考本地 .bru 文件约定,再生成对应路径与命名的新文件。
适用场景:为已有 Bruno 项目补充 API 请求文件,尤其是需要按文档和项目既有规范快速生成结构化请求时。
限制:依赖可访问的 API 文档来源(WebFetch 或 context7);需要项目内已有 Bruno .bru 文件可供参考;目标 API 不明确时会先提问;资料未说明支持的 Bruno 版本、认证类型范围或错误处理细节。