🔍 主要功能：当CLI不够用，AI自己去找接口

飞书官方提供了数百个OpenAPI接口，但日常用的lark-cli只封装了最常用的一部分。Lark-OpenAPI-Explorer的存在就是为了填补这个空白——它是一个让AI能自己去飞书官方文档里“翻”接口的技能。 它的核心工作方式很直接：当用户的需求无法被现有lark-*技能或CLI已注册命令满足时，这个技能会引导AI从飞书的Markdown文档库中逐层挖掘原生OpenAPI接口，然后通过lark-cli api裸调来完成任务。 具体来说，它遵循一套严谨的挖掘流程： 先检查已有能力：用lark-cli <service> --help确认确实没有现成命令可用，避免重复劳动。 从顶层索引定位模块：通过WebFetch获取llms.txt顶层索引，找出与需求相关的模块文档链接。 从模块文档定位具体API：进入模块文档，找到目标API的说明和文档链接。 获取完整API规范：提取HTTP方法、路径、参数、权限scope、错误码等完整信息。 通过CLI执行调用：用lark-cli api按GET、POST、PUT、DELETE方式执行。 整个过程不需要开发者手动翻文档、找参数、拼接URL——AI全自动完成。

🚀 首次安装：两步到位，和安装其他lark技能一样简单

Lark-OpenAPI-Explorer是飞书CLI工具集中的一个技能（Skill），安装方式和其他lark技能完全一致。 第一步：确保lark-cli已安装 如果你的电脑上还没有飞书CLI工具，先执行： bash npx @larksuite/cli@latest install 第二步：安装OpenAPI Explorer技能 在终端中运行以下命令： bash npx skills add https://github.com/larksuite/cli --skill lark-openapi-explorer 或者使用简写形式： bash npx skills add larksuite/cli -y -g 安装完成后，记得先完成飞书账号的登录认证（lark-cli auth login --recommend），让AI获得操作权限。前置条件和安全规则与lark系列其他技能保持一致。

🎯 主要应用场景：什么时候该用这个技能？

这个技能的定位非常明确——它是lark-cli的“能力补充”，而不是日常首选。 场景一：现有CLI命令没有覆盖的需求 比如你想调用一个飞书新发布的接口，或者某个不太常用的API，但lark-cli里没有对应的快捷命令。这时候OpenAPI Explorer就能派上用场——让AI自动去文档里找出来并调用。 场景二：开发自定义Skill时的调研阶段 如果你想基于飞书API封装一个全新的技能，在开始写SKILL.md之前，需要先搞清楚调用哪个API、需要什么权限、参数怎么写。OpenAPI Explorer能帮你快速完成这个“调研”环节。 场景三：AI工作流中的“万能接口” 当你在Cursor、Claude Code等AI编程助手中搭建自动化流程时，如果某个操作恰好没有被现有的CLI命令覆盖，OpenAPI Explorer就像一个“万能钥匙”，随时去官方文档里找接口来补上缺口。

💡 使用帮助：AI怎么“读文档”来调用接口？

这可能是这个插件最特别的地方——它让AI具备了阅读官方Markdown文档并提取接口规范的能力。 文档入口：飞书和Lark的OpenAPI文档以Markdown层级组织： 顶层索引：https://open.feishu.cn/llms.txt 模块文档：llms-<module>.txt 具体API文档：<api>.md 品牌自动适配：如果用户用的是飞书（Feishu），AI会访问open.feishu.cn；如果是Lark国际版，则用open.larksuite.com。不确定时默认使用飞书。 输出格式：AI向用户呈现挖掘结果时，会按以下结构组织： API名称与功能 HTTP方法与完整路径 关键参数（必填和常用可选） 所需权限scope 完整的lark-cli api调用示例 注意事项（频率限制、特殊约束等） 安全规则：写入/删除类API（POST、PUT、DELETE）调用前必须确认用户意图，涉及敏感操作（如删除数据、移除成员）更需格外谨慎。

🤖 适合哪些AI工具？

这个技能是为AI Agent（智能体）设计的，与lark系列其他技能一样，天然适配各类支持Skills机制的AI环境。 AI编程助手：Cursor、Claude Code等工具中可以直接调用，让编程助手在编码之外，还能临时帮你查接口、调API。 AI工作流平台：如果你在使用Dify、Coze等平台搭建AI应用，可以将OpenAPI Explorer作为一个灵活的“工具节点”，赋予你的AI应用动态调用任意飞书接口的能力。 飞书CLI生态：它本身就是飞书CLI工具链的一部分，与lark-skill-maker等其他技能配合使用，形成“调研API → 封装成新Skill → 日常使用”的完整闭环。

📝 总结

Lark-OpenAPI-Explorer不是一个给普通人用的图形化调试工具——飞书官方已经有API调试台可以做这件事。它的独特价值在于让AI自己能看懂飞书的官方文档，然后替你完成接口调用。 它解决的核心痛点是：开发者面对几百个OpenAPI接口，不可能记住每一个的路径、参数和权限要求。有了这个技能，AI替你翻文档、查接口、拼命令。你只需要用自然语言说出“我需要做某某事”，剩下的交给AI去文档里找答案。 如果你已经在用飞书CLI和AI编程助手，这个技能会让你的自动化能力边界扩展一大截。