mcpField
F
feishu-cli-platform

feishu-cli-platform

github.com/riba2534Development1.4k134 installsUpdated 3w ago
Repository

About feishu-cli-platform

feishu-cli-platform is a skill for routing Feishu tasks to the relevant workflow, intended for tasks such as API calls, content searches, and directory lookups. It emphasizes identity selection, request previews, and clear read/write boundaries.

Key features

  1. 01Routes tasks by intent
  2. 02Covers auth, API, schema, and search
  3. 03Includes directory lookup workflows
  4. 04Previews write requests with dry-run
  5. 05Separates platform and domain skills

Use cases

  1. 01Look up users, departments, or contact details
  2. 02Inspect an API schema before calling it
  3. 03Check authorization scopes for a profile
  4. 04Preview parameters before a write request

Install

Copy the command and run it in a terminal.

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

After installing, type/feishu-cli-platformin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project 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

Comments

Markdown supported