Agent Skills
返回列表
猫度飞书

猫度飞书

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_110580e2/mdfeishu。

技能介绍

要解决什么问题

工作区管理员要在猫度里把飞书企业自建应用接进来:事件能打到后端、群里 @ 机器人能走到 Home Agent,而不是卡在 URL 校验、challenge 或穿透端口上。本技能不承接选题、选品、口播等业务,那些应走 maodu 或 maodu-selection 等主技能;这里只谈飞书绑定、Webhook 与机器人行为。

技能如何工作

助手经 MCP(call_api 等)对工作区设置做读写,对用户用自然中文说明,不贴原始 JSON 或工具名。典型路径:

  • 绑定管理:列出 / 创建 / 更新 / 删除 /api/workspace-settings/feishu-apps 下的飞书应用绑定
  • 元数据:读取 …/feishu-apps/meta,弄清共享 Webhook 路径及可选智能体、成员列表
  • 架构说明:多飞书 App 共用 POST /api/webhooks/feishu/event,靠 Verification Token 或 Encrypt Key 识别是哪条绑定
  • 运行时:私聊或群内 @ 机器人 → Home Agent

排查时会对照:challenge 是否非 JSON、穿透是否未指向 backend:3000(本地开发不是 MCP 3100)、绑定是否未启用、算力是否不足、群聊是否未 @ 机器人。

边界与注意点

  • 权限:仅工作区 owner/admin 可改绑定;health_check / workspace_me 免扣算力,业务 call_api 每次扣 1 点
  • 硬性安全:App Secret、Token 等只引导去猫度「设置 → 飞书机器人」填写;即使用 MCP 写入,也不在对话里回显完整密钥
  • 开放平台侧需自建应用、订阅 im.message.receive_v1、事件地址为 {PUBLIC_BASE_URL}/api/webhooks/feishu/event,并在猫度侧启用对应绑定

使用场景

  • 新建飞书自建应用后,要在猫度工作区创建绑定并核对事件订阅地址是否指向 `/api/webhooks/feishu/event`
  • 飞书控制台 URL 校验或 challenge 失败,需要对照穿透是否打到 Nest 3000 与请求体是否为合法 JSON
  • 群聊里机器人无响应,需确认是否 @ 机器人、绑定已启用且工作区算力未耗尽
  • 多个飞书 App 共用同一 Webhook 时,要搞清靠 Verification Token 或 Encrypt Key 区分哪条绑定

适合人员

  • 猫度工作区 owner/admin,要首次对接飞书机器人并开通 im.message.receive_v1
  • 负责内网穿透或本地联调的工程师,需把公网回调指到 backend:3000 而非 MCP 3100
  • 运维排查「飞书收不到消息」时,要按绑定列表、meta 与 Home Agent 链路逐步定位
  • 只配置凭证、不愿在聊天里暴露 App Secret 的管理员,需要按设置页填写而非让助手回显密钥