飞书协作自动化助手

一、触发场景

• "把这条数据写进飞书多维表格" / "飞书表格自动记录"
• "用飞书机器人发一条通知" / "推送到飞书群"
• "帮我生成/整理飞书云文档"
• "把日程同步到飞书日历"
• 配置飞书自建应用、接入飞书 MCP、排查飞书 API 报错

二、平台能力与接入（真实信息，已联网核对）

• 官方 API 根域名：https://open.feishu.cn/open-apis/（国际版 https://open.larksuite.com/open-apis/）
• 官方 MCP（最推荐）：包名 @larksuiteoapi/lark-mcp，通过 npx 运行；需要 FEISHU_APP_ID 与 FEISHU_APP_SECRET，可选 FEISHU_DOMAIN（默认飞书 feishu.cn）。工具覆盖：多维表格(bitable)、消息(im)、云文档(docx)、日历(calendar)、通讯录(contact) 等。
• 自建应用凭证：在 飞书开放平台(https://open.feishu.cn) 创建企业自建应用，获取 App ID / App Secret；在"权限管理"勾选所需 scope（如 bitable:app / im:message / docx:document / calendar:calendar）；发布后生效。
• 获取 tenant_access_token：POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal（app_id+app_secret），用于调用开放 API。

三、工作流

1. 确认用户目标（表格 / 消息 / 文档 / 日历）。
2. 检查是否已配置飞书应用凭证与 MCP；未配置 → 引导到 USAGE.md 完成配置。
3. 通过 MCP 工具或 API 调用执行动作（如 bitable 追加记录、im 发送消息、calendar 创建日程）。
4. 返回结果摘要；失败时给出错误码与排查建议（权限未开 / 应用未发布 / token 过期 / 频控）。

四、红线与边界

• 仅操作用户自有应用与授权范围内的数据，不越权读取他人空间。
• 不存储、不泄露 App Secret；Secret 仅存于用户本地 mcp.json / 环境变量，不回传。
• 遵守飞书频控（单应用有 QPS 上限），批量操作做好节流，避免触发限流。
• 本 Skill 提供方法指引与调用骨架，不代替用户持有凭证调真实接口；最终以飞书官方文档最新版为准。

五、配置指引（详见 USAGE.md）

WorkBuddy mcp.json 接入飞书官方 MCP 示例：

{
  "mcpServers": {
    "feishu": {
      "command": "npx",
      "args": ["-y","@larksuiteoapi/lark-mcp","mcp","-a","<APP_ID>","-s","<APP_SECRET>","-m","stdio"]
    }
  }
}