lark-openapi-explorer
飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足，需要查找并调用原生飞书 OpenAPI 时使用。
By larksuite · 434,141 installs
npx skills add larksuite/cli --skill lark-openapi-explorer
Source repository · Upstream listing
OpenAPI Explorer
前置条件： 先阅读 [ ../lark shared/SKILL.md ](../lark shared/SKILL.md) 了解认证、身份切换和安全规则。
当用户的需求 无法被现有 skill 或 CLI 已注册 API 覆盖 时，使用本技能从飞书官方 markdown 文档库中逐层挖掘原生 OpenAPI 接口，然后通过 lark cli api 裸调完成任务。
文档库结构
飞书 OpenAPI 文档以 markdown 层级组织：
文档入口：
品牌 入口 URL
飞书 (Feishu) https://open.feishu.cn/llms.txt
Lark https://open.larksuite.com/llms.txt
所有文档以 中文 编写。如果用户使用英文交流，需将文档内容翻译为英文后输出。
挖掘流程
严格按以下步骤逐层检索， 不要跳步或猜测 API ：
Step 1：确认现有能力不足
如果已有对应命令或 shortcut，直接使用， 不需要继续挖掘 。
Step 2：从顶层索引定位模块
用 WebFetch 获取顶层索引，找到与需求相关的模块文档链接：
飞书品牌使用 open.feishu.cn
Lark 品牌使用 open.larksuite.com
如不确定用户品牌，默认使用飞书
Step 3：从模块文档定位具体 API
用 WebFetch 获取模块文档，找到具体 API 的文档链接：
Step 4：获取 API 完整规范
用 WebFetch 获取具体 API 文档，提取完整的调用规范：
Step 5：通过 CLI 调用 API
使用 lark cli api 裸调：
输出规范
向用户呈现挖掘结果时，按以下格式组织：
1. API 名称与功能 ：一句话描述
2. HTTP 方法与路径 ： METHOD /open apis/...
3. 关键参数 ：列出必填和常用可选参数
4. 所需权限 ：scope 列表
5. 调用示例 ：给出 lark cli api 的完整命令
6. 注意事项 ：频率限制、特殊约束等
如果用户使用英文交流，将以上所有内容翻译为英文。
安全规则
写入/删除类 API （POST/PUT/DELETE）调用前必须确认用户意图
建议先用 dry run 预览请求（如支持）
不要猜测 API 路径或参数——必须从文档中获取确认
涉及敏感操作（删除群、移除成员等）时，向用户说明影响范围
使用场景示例
场景 1：用户需要拉人进群（未被 CLI 封装）
场景 2：用户需要设置群公告
参考
[lark shared](../lark shared/SKILL.md) — 认证和全局参数
[lark skill maker](../lark skill maker/SKILL.md) — 如需将挖掘到的 API 固化为新 Skill