mcpField
F
feishu-cli-platform

feishu-cli-platform

github.com/riba2534开发1.4k134 次安装3 周前更新
代码仓库

关于 feishu-cli-platform

feishu-cli-platform 是用于按意图选择飞书平台工作流的技能，面向调用飞书 API、搜索内容或查询通讯录的任务。它通过分流到专门流程，并强调身份选择、请求预览和读写边界。

主要功能

  1. 01按意图路由到对应工作流
  2. 02覆盖认证、API、Schema 与搜索
  3. 03支持通讯录查询流程
  4. 04写请求先用 dry-run 预览
  5. 05区分平台能力与领域技能边界

适用场景

  1. 01查询用户、部门或联系信息
  2. 02先查接口 Schema 再调用 API
  3. 03检查当前 profile 的授权范围
  4. 04执行写请求前预览参数

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-platform

安装后在 Claude Code 中输入/feishu-cli-platform确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
references/workflows/api/
workflow.md
references/workflows/api/references/
embedded-api-discovery.md
references/workflows/auth/
workflow.md
references/workflows/auth/references/
identity.md
references/workflows/directory/
workflow.md
references/workflows/schema/
workflow.md
references/workflows/search/
workflow.md
references/workflows/search/references/
commands.md

详细介绍

来自项目 README

飞书平台能力

先判断意图，再读取对应工作流。不要一次加载全部 reference。 加载后，将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

意图读取文件
登录、登出、scope 预检、Token、profile、config、doctorreferences/workflows/auth/workflow.md
调任意 OpenAPI、--as、分页和 dry-runreferences/workflows/api/workflow.md
查询本地 OpenAPI path、参数和 scopereferences/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。

执行规则

  1. 仓库开发优先使用刚编译的 bin/feishu-cli（make build）或 ./feishu-cli；安装环境使用 PATH 中的 feishu-cli。
  2. 先确定执行身份。auth check --scope 只检查当前 profile 的本地 User Token，不能验证 Bot 权限或显式 Token；Bot 的权限看应用配置和实际接口结果。不要回显真实 Token。
  3. 多 Bot / 不确定当前应用时先 profile list --json；单次用 --profile <name>，不改默认指针。环境变量覆盖了目标 App 时，沿用已有授权在本次进程移除对应覆盖，或用 --bot-app-id/--bot-app-secret 指定正确凭证，不修改用户全局环境。
  4. api 的所有写请求均可先用 CLI 本地 --dry-run 预览；预览不代表服务端接受。其他命令按各自帮助选择验证方式。
  5. 搜索与通讯录结果默认只读取；用户要求后续写操作时再切换到对应领域 Skill。

领域边界

  • 文档读写与导入导出：feishu-cli-docs
  • 云盘、知识库、评论和权限：feishu-cli-storage
  • 消息、群聊、卡片和事件：feishu-cli-messaging
  • Sheet/Bitable：feishu-cli-data

评论

支持 Markdown