飞书助手（feishu-assistant）由 43 COLLEGE 凯寓（KAIYU）出品，版本 v2.0，通过飞书 Open API 实现消息、文档、知识库、日历、群聊、多维表格、邮箱等操作。
一、用途 该技能用于在飞书内执行各类协作操作，包括发消息、写文档、查知识库、看群聊、管理任务、操作多维表格、查邮件、发邮件、收件箱等。当用户提到飞书相关操作时使用此技能。
二、主要能力
- 消息：发送文本消息（支持 text/post/interactive/image），向群组发消息，读取群消息。
- 群聊管理：创建群聊并拉入成员、添加或移除成员、获取与修改群聊信息、列出群成员、解散群聊（不可恢复）。
- 文档：创建文档、更新文档。
- 知识库：列出所有知识库空间、列出空间下的文章、读取文章纯文本内容。
- 通讯录与组织：显示团队通讯录（从缓存读取）、刷新通讯录缓存、显示知识库列表、刷新知识库缓存、显示组织信息、通过邮箱查用户。
- 文件上传：上传文件到指定父节点。
- 日历：查看日历列表、查看指定时间范围内的日程、创建日程、查看日程详情、修改日程、删除日程、查询忙闲信息（查自己或指定同事）、推荐多人共同空闲时段。
- 任务管理：创建任务（可带截止时间）、查看任务列表、获取任务详情、更新任务标题或描述、标记任务为已完成。任务管理使用飞书 Task v2 API，需要用户授权（user_token）。
- 电子表格（Sheets）：创建电子表格、读取表格数据、写入数据、追加数据到表格末尾。token 从表格 URL 提取，格式为 https://xxx.feishu.cn/sheets/{token}。
- 多维表格（Base）：列出数据表、列出字段、列出记录、获取单条记录、创建记录、批量创建记录、更新记录、删除记录、创建数据表、创建字段。app_token 从多维表格 URL 提取，格式为 https://xxx.feishu.cn/base/{app_token}。
- 邮箱（Mail）：获取当前用户邮箱地址、查看收件箱、查看已发送、读取邮件、搜索邮件、发送邮件（默认 HTML 格式，支持纯文本、多收件人、抄送）、创建草稿。发送邮件前必须确认收件人和内容。
三、使用方式 首次配置：如果命令报错找不到 config.json 或 app_id 为空，读取本目录下的 SETUP.md 并按其中的流程引导用户完成配置。
平台说明（跨平台兼容）：
- Python 命令：macOS/Linux 用 python3，Windows 用 python。调用前先检测哪个可用。
- 路径格式：macOS/Linux 为 ~/.claude/skills/feishu-assistant/；Windows 为 %USERPROFILE%.claude\skills\feishu-assistant\。
- 所有命令通过 python3 scripts/feishu_client.py <command>（macOS/Linux）或 python scripts\feishu_client.py <command>（Windows）调用。执行前必须先 cd 到本 skill 的根目录。
双模式架构：feishu_client.py 支持两种运行模式，自动选择。
- 直连模式：config.json 中有 app_secret + cache/user_token.json，直接调飞书 API，最快。
- lark-cli 代理模式：无 app_secret 或无 user_token，但有 lark-cli，通过 lark-cli api 代理请求，零配置。 已有配置（app_secret + OAuth token）的老用户继续走直连模式，无任何影响。新用户通过 lark-cli 配置后，所有请求自动走 lark-cli 代理，无需手动管理 token。
缓存说明：
- 通讯录：scripts/cache/contacts.json，格式 [{"name": "张三", "open_id": "ou_xxx", ...}]。
- 知识库列表：scripts/cache/wiki_spaces.json，格式 [{"name": "空间名", "space_id": "xxx", ...}]。
- 默认群聊 ID：scripts/config.json 的 default_chat_id。
- team_members：scripts/config.json 的 team_members（姓名 → open_id 映射）。
- 如果缓存不存在，运行 refresh-contacts 或 refresh-spaces 生成。
四、适用场景 适用于需要在飞书内批量或自动化处理日常协作事务的场景，例如给同事或群组发消息、创建与维护文档和知识库、管理群聊成员、安排日程与会议、管理任务、读写电子表格与多维表格数据、收发邮件等。
五、限制与注意事项
- 任务管理使用飞书 Task v2 API，需要用户授权（user_token）。
- 发送邮件前必须确认收件人和内容。
- 解散群聊不可恢复。
- 发消息前，先从 config.json 的 team_members 查找目标同事的 open_id。
- 电子表格（Sheets）是传统行列表格，适合简单数据录入和计算；多维表格（Base）是结构化数据库，支持字段类型、视图、关联等高级功能。
- 忙闲查询（query-freebusy）查一个人的忙碌时段列表（含 RSVP 状态），只返回时间不返回日程详情；空闲推荐（suggest-meeting-time）查多人，自动计算共同空闲，返回最多 5 个推荐时段。
故障排除：
- config.json 不存在：未运行安装引导，运行 python3 scripts/setup.py。
- lark-cli 未安装：无 lark-cli 且无 app_secret，执行 npm install -g @larksuite/cli && lark-cli config init --new && lark-cli auth login --domain all。
- lark-cli 调用失败：token 过期，执行 lark-cli auth login --domain all 重新授权。
- 通讯录/知识库缓存为空：未刷新缓存，运行 refresh-contacts 或 refresh-spaces。
- Bot has NO availability：机器人可用范围不含目标用户，在飞书开放平台将应用可用范围设为「所有员工」并重新发布。
- 权限不足：缺少所需 scope，执行 lark-cli auth login --domain all 补充授权。 飞书开放平台后台：https://open.feishu.cn/app