lark-openapi-explorerlisted

# OpenAPI Explorer > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) 了解认证、身份切换和安全规则。 当用户的需求**无法被现有 skill 或 CLI 已注册 API 覆盖**时，使用本技能从飞书官方 markdown 文档库中逐层挖掘原生 OpenAPI 接口，然后通过 `lark-cli api` 裸调完成任务。 ## 文档库结构 飞书 OpenAPI 文档以 markdown 层级组织： ``` llms.txt ← 顶层索引，列出所有模块文档链接 └─ llms-<module>.txt ← 模块文档，包含功能概述 + 底层 API 文档链接 └─ <api-doc>.md ← 单个 API 的完整说明（方法/路径/参数/响应/错误码） ``` 文档入口： | 品牌 | 入口 URL | |------|----------| | 飞书 (Feishu) | `https://open.feishu.cn/llms.txt` | | Lark | `https://open.larksuite.com/llms.txt` | > 所有文档以**中文**编写。如果用户使用英文交流，需将文档内容翻译为英文后输出。 ## 挖掘流程 严格按以下步骤逐层检索，**不要跳步或猜测 API**： ### Step 1：确认现有能力不足 ```bash # 先检查是否已有对应的 skill 或已注册 API lark-cli <可能的service> --help ``` 如果已有对应命令或 shortcut，直接使用，**不需要继续挖掘**。 ### Step 2：从顶层索引定位模块 用 WebFetch 获取顶层索引，找到与需求相关的模块文档链接： ``` WebFetch https://open.feishu.cn/llms.txt → 提取问题："列出所有模块文档链接，找出与 <用户需求关键词> 相关的链接" ``` - 飞书品牌使用 `open.feishu.cn` - Lark 品牌使用 `open.larksuite.com` - 如不确定用户品牌，默认使用飞书 ### Step 3：从模块文档定位具体 API 用 WebFetch 获取模块文档，找到具体 API 的文档链接： ``` WebFetch https://open.feishu.cn/llms-docs/zh-CN/llms-<module>.txt → 提取问题："找出与 <用户需求> 相关的 API 说明和文档链接" ``` ### Step 4：获取 API 完整规范 用 WebFetch 获取具体 API 文档，提取完整的调用规范： ``` WebFetch https://open.feishu.cn/document/server-docs/.../<api>.md → 提取问题："返回完整 API 规范：HTTP 方法、URL 路径、路径参数、查询参数、请求体字段（名称/类型/必填/说明）、响应字段、所需权限、错误码" ``` ### Step 5：通过 CLI 调用 API 使用 `lark-cli api` 裸调： ```bash # GET 请求 lark-cli api G