飞书平台能力
先判断意图,再读取对应工作流。不要一次加载全部 reference。
加载后,将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析;执行脚本时使用解析后的实际路径,不要依赖当前 shell 目录。
路由
| 意图 | 读取文件 |
|---|---|
| 登录、登出、scope 预检、Token、profile、config、doctor | references/workflows/auth/workflow.md |
调任意 OpenAPI、--as、分页和 dry-run | references/workflows/api/workflow.md |
| 查询本地 OpenAPI path、参数和 scope | references/workflows/schema/workflow.md |
| 搜索文档、消息或应用 | references/workflows/search/workflow.md |
| 查询用户、邮箱、手机号、部门 | references/workflows/directory/workflow.md |
涉及身份选择时读取 references/workflows/auth/references/identity.md;auth check 不是 Bot 权限检查。
Schema 只负责发现接口;API 负责执行请求。通常先查 schema,再调用 api。
执行规则
- 仓库开发优先使用刚编译的
bin/feishu-cli(make build)或./feishu-cli;安装环境使用 PATH 中的feishu-cli。 - 先确定执行身份。
auth check --scope只检查当前 profile 的本地 User Token,不能验证 Bot 权限或显式 Token;Bot 的权限看应用配置和实际接口结果。不要回显真实 Token。 - 多 Bot / 不确定当前应用时先
profile list --json;单次用--profile <name>,不改默认指针。环境变量覆盖了目标 App 时,沿用已有授权在本次进程移除对应覆盖,或用--bot-app-id/--bot-app-secret指定正确凭证,不修改用户全局环境。 api的所有写请求均可先用 CLI 本地--dry-run预览;预览不代表服务端接受。其他命令按各自帮助选择验证方式。- 搜索与通讯录结果默认只读取;用户要求后续写操作时再切换到对应领域 Skill。
领域边界
- 文档读写与导入导出:
feishu-cli-docs - 云盘、知识库、评论和权限:
feishu-cli-storage - 消息、群聊、卡片和事件:
feishu-cli-messaging - Sheet/Bitable:
feishu-cli-data