该技能用于飞书/Lark 原生 OpenAPI 的探索与调用,适用于现有 skill 或 lark-cli 已注册命令无法覆盖用户需求、需要查找并直接调用原生 OpenAPI 的场景。使用前需先阅读 ../lark-shared/SKILL.md 了解认证、身份切换和安全规则。
文档库以 markdown 层级组织:顶层索引 llms.txt 列出所有模块文档链接;模块文档 llms-<module>.txt 包含功能概述与底层 API 文档链接;单个 API 文档 .md 含方法、路径、参数、响应与错误码。入口:飞书为 https://open.feishu.cn/llms.txt,Lark 为 https://open.larksuite.com/llms.txt。文档为中文,如用户使用英文需翻译输出。
挖掘流程分五步:先用 lark-cli <service> --help 确认现有能力不足;再用 WebFetch 获取顶层索引定位模块;再获取模块文档定位具体 API;再获取 API 完整规范(HTTP 方法、URL 路径、路径/查询参数、请求体字段、响应字段、权限、错误码);最后通过 lark-cli api 裸调,例如 GET 用 lark-cli api GET /open-apis/<path> --params '{"key":"value"}',POST 用 lark-cli api POST /open-apis/<path> --data '{"key":"value"}',另有 PUT、DELETE。
呈现结果时组织为:API 名称与功能、HTTP 方法与路径、关键参数、所需权限、调用示例、注意事项;用户使用英文时需全部翻译。
限制与安全:写入/删除类 API(POST/PUT/DELETE)调用前必须确认用户意图;建议先用 --dry-run 预览(如支持);不要猜测 API 路径或参数,必须从文档确认;涉及敏感操作(删除群、移除成员等)需向用户说明影响范围。