mcpField
F
feishu-cli-platform

feishu-cli-platform

github.com/riba2534開発1.4k134 回インストール3 週間前に更新
リポジトリ

feishu-cli-platform について

feishu-cli-platformは、API呼び出しや検索、連絡先の照会などのFeishuタスクを適切なワークフローへ振り分けるスキルです。実行主体の選択、リクエストの事前確認、読み取りと書き込みの境界を明確にします。

主な機能

  1. 01意図に応じたワークフロー振り分け
  2. 02認証、API、スキーマ、検索への対応
  3. 03連絡先照会ワークフロー
  4. 04書き込みリクエストのdry-run確認
  5. 05プラットフォームと領域別スキルの区分

活用シーン

  1. 01ユーザー、部署、連絡先情報の照会
  2. 02API呼び出し前のスキーマ確認
  3. 03profileの権限スコープ確認
  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 対応