用途
本技能用于实现飞书（Lark）平台的全通道自动化，通过 lark-mcp 工具对飞书各项能力进行程序化操作。当需要操作飞书平台、同步数据到飞书表格、发送飞书通知、管理飞书文档或自动化飞书业务流程时使用。
主要能力
- 多维表格（Bitable）：创建多维表格和数据表，添加、修改、删除字段，增删改查记录数据，批量导入导出数据，数据筛选和排序。
- 消息发送：发送文本、富文本、卡片消息，支持群组消息和私聊消息，支持消息模板和交互式卡片，支持文件和图片发送。
- 文档管理：搜索云文档、创建新文档、编辑文档内容、文档权限管理、文档协作者管理。
- 群组管理：创建群组、添加/移除成员、获取群组列表、群组信息查询。
- 知识库（Wiki）：搜索知识库节点、获取节点详情、创建和管理知识库内容。
- 日历和任务：创建和查询日历事件、创建和管理任务、任务分配和跟踪。
使用方式
使用前先检查 lark-mcp 工具是否可用，可用工具前缀为 mcp__lark-mcp_。
发送测试消息示例：
await mcp__lark-mcp_sendMessage({
receive_id: "oc_xxxxxxxxx",
msg_type: "text",
content: JSON.stringify({
text: "Hello from Clawdbot!"
})
});
常用 API 工具包括：多维表格相关（createBitable、createTable、addRecord、updateRecord、deleteRecord、searchRecords、getRecord）；消息相关（sendMessage、getMessages、replyMessage）；文档相关（searchDocs、createDoc、getDoc、updateDoc、setDocPermission）；群组相关（createGroup、addMember、getGroupList、getGroupInfo）。
Markdown 导入云文档
可将本地 Markdown 文件导入为飞书云文档，格式完整保留。流程为：获取 access_token → 上传 md 文件到飞书云盘（drive/v1/files/upload_all）→ 导入为飞书云文档（drive/v1/import_tasks）→ 轮询 import_tasks/{ticket} 获取结果。支持的导入格式：md → Markdown、docx → Word 文档、xlsx → Excel 表格。导入是异步操作，mount_type: 1 表示导入到“我的空间”，导入后的文档 URL 格式为 https://xxx.feishu.cn/docx/{token}。
完整输出云文档流程
每次输出云文档时需完成：生成本地 Markdown 文件 → 上传到飞书云盘 → 导入为云文档 → 设置权限为组织内可编辑（drive/v1/permissions/{token}/public）→ 发送链接到目标群。权限设置中 link_share_entity: "tenant_editable" 表示组织内获得链接的人可编辑，comment_entity: "anyone_can_view" 表示任何人可评论，share_entity: "anyone" 表示任何人可分享。
适用场景
- 自动化日报收集：每日定时创建表格记录，成员填写日报，自动汇总统计并发送到群组。
- 审批流程：创建审批表格，监听状态变更，自动通知审批人，记录审批历史。
- 任务管理：创建任务表格，分配任务给成员，发送任务提醒，跟踪完成状态。
- 客户管理：客户信息表格、跟进记录、自动提醒、数据可视化。
- 报表生成：从表格提取数据，生成统计报表，创建飞书文档，定期推送更新。
- 进阶用法：Webhook 集成（监听飞书 Webhook 事件、自动触发工作流、实时数据同步）、自动化定时任务（定时发送报告、自动数据备份、定期清理）、跨平台集成（与 GitHub 集成同步 Issue、与邮件集成推送通知、与日历集成管理日程）。
限制与注意事项
- 认证配置：使用提供的 App ID 和 App Secret，遵守 API 调用频率限制，缓存 access_token。
- 数据操作：批量操作使用分页，数据写入前验证格式，做好错误处理和重试，记录操作日志。
- 消息发送：使用交互式卡片提升体验，合理控制发送频率，避免发送敏感信息。
- 权限管理：遵循最小权限原则，定期审查权限，管理协作者生命周期。
- 常见错误：权限不足需检查应用权限配置；限流错误需实现重试和等待；无效 ID 需验证用户/群组 ID 格式；网络错误需实现重试机制。重试策略可采用指数退避算法、最大重试次数限制、记录失败请求、通知管理员。
- 安全注意事项：保护 App Secret，不要在日志中记录敏感信息，使用环境变量管理凭证，定期轮换访问令牌，遵守数据隐私法规。
- 故障排查：MCP 工具不可用时重启 Claude Desktop、检查网络连接、验证凭证是否有效、查看错误日志；API 调用失败时检查应用权限配置、验证用户/群组 ID、查看限流状态、检查数据格式；权限不足时登录飞书开放平台检查应用权限范围、重新授权、等待权限生效。