飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。
**当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息
インストールする前に、エージェントに与えられる指示の中身を確認できます。
feishu_im_user_get_messages 中 open_id 和 chat_id 必须二选一thread_id 时，根据用户意图判断是否用 feishu_im_user_get_thread_messages 读取话题内回复feishu_im_user_fetch_resource 下载，需要 message_id + file_key + type| 用户意图 | 工具 | 必填参数 | 常用可选 |
|---|---|---|---|
| 获取群聊/单聊历史消息 | feishu_im_user_get_messages | chat_id 或 open_id（二选一） | relative_time, start_time/end_time, page_size, sort_rule |
| 获取话题内回复消息 | feishu_im_user_get_thread_messages | thread_id（omt_xxx） | page_size, sort_rule |
| 跨会话搜索消息 | feishu_im_user_search_messages | 至少一个过滤条件 | query, sender_ids, chat_id, relative_time, start_time/end_time, page_size |
| 下载消息中的图片 | feishu_im_user_fetch_resource | message_id, file_key（img_xxx）, type="image" | - |
| 下载消息中的文件/音频/视频 | feishu_im_user_fetch_resource | message_id, file_key（file_xxx）, type="file" | - |
当用户没有明确指定时间范围时，根据用户意图推断合适的 relative_time，确保返回的消息能完整覆盖用户关心的内容。用户明确指定时间时直接使用用户的值。
page_size 范围 1-50，默认 50has_more=true 时，可使用 page_token 继续获取下一页获取历史消息时，返回的消息中如果包含 thread_id 字段，推荐主动获取话题的最新 10 条回复（page_size: 10, sort_rule: "create_time_desc"）以提供更完整的上下文。
| 场景 | 行为 |
|---|---|
| 获取历史消息并需要理解上下文（默认） | 对发现的 thread_id 调用 feishu_im_user_get_thread_messages 获取最新 10 条回复 |
| 用户要求"完整对话"、"详细讨论"、"看看回复" | 获取话题全部回复（page_size: 50, sort_rule: "create_time_asc"），需要时翻页 |
| 用户只浏览消息概览 / 用户明确说不看回复 | 跳过话题展开 |
注意：话题消息不支持时间过滤（飞书 API 限制），只能通过分页获取。
feishu_im_user_search_messages 支持跨所有会话搜索消息：
| 参数 | 说明 |
|---|---|
query | 搜索关键词，匹配消息内容 |
sender_ids | 发送者 open_id 列表 |
chat_id | 限定搜索范围的会话 ID |
mention_ids | 被@用户的 open_id 列表 |
message_type | 消息类型：file / image / media |
sender_type | 发送者类型：user / bot / all（默认 user） |
chat_type | 会话类型：group / p2p |
搜索结果每条消息额外包含 chat_id、chat_type（p2p/group）、chat_name。单聊消息还有 chat_partner（对方 open_id 和名字）。
消息内容中可能出现以下资源标记，用 feishu_im_user_fetch_resource 下载：
| 资源类型 | 内容中的标记格式 | fetch_resource 参数 |
|---|---|---|
| 图片 |  | message_id=om_xxx, file_key=img_xxx, type="image" |
| 文件 | <file key="file_xxx" .../> | message_id=om_xxx, file_key=file_xxx, type="file" |
| 音频 | <audio key="file_xxx" .../> | message_id=om_xxx, file_key=file_xxx, type="file" |
| 视频 | <video key="file_xxx" .../> | message_id=om_xxx, file_key=file_xxx, type="file" |
从消息的 message_id 字段和内容中的 file_key 组合即可调用 fetch_resource。
注意：文件大小限制 100MB，不支持下载表情包、卡片中的资源。
feishu_im_user_get_messages 和 feishu_im_user_search_messages 支持时间过滤，话题消息不支持。
| 方式 | 参数 | 示例 |
|---|---|---|
| 相对时间 | relative_time | today、yesterday、this_week、last_3_days、last_24_hours |
| 精确时间 | start_time + end_time | ISO 8601 格式：2026-02-27T00:00:00+08:00 |
relative_time 和 start_time/end_time 互斥，不能同时使用today、yesterday、day_before_yesterday、this_week、last_week、this_month、last_month、last_{N}_{unit}（unit: minutes/hours/days）| 参数 | 格式 | 适用场景 |
|---|---|---|
| chat_id | oc_xxx | 已知会话 ID（群聊或单聊均可） |
| open_id | ou_xxx | 已知用户 ID，获取与该用户的单聊消息（自动解析为 chat_id） |
两者必须二选一，优先使用 chat_id。
步骤 1：获取群聊消息
{ "chat_id": "oc_xxx" }
步骤 2：返回的消息中发现 thread_id，展开话题最新回复：
{ "thread_id": "omt_xxx", "page_size": 10, "sort_rule": "create_time_desc" }
{ "query": "项目进度", "chat_id": "oc_xxx" }
第一次调用返回 has_more: true 和 page_token: "xxx"，继续获取：
{ "chat_id": "oc_xxx", "page_token": "xxx" }
{ "message_id": "om_xxx", "file_key": "img_v3_xxx", "type": "image" }
| 错误现象 | 根本原因 | 解决方案 |
|---|---|---|
| 消息结果太少 | 时间范围太窄或未传时间参数 | 根据用户意图推断合适的 relative_time |
| 消息不完整 | 没有检查 has_more 并翻页 | has_more=true 时用 page_token 翻页 |
| 话题讨论内容不完整 | 没有展开 thread_id | 发现 thread_id 时获取话题回复 |
| "open_id 和 chat_id 不能同时提供" | 同时传了两个参数 | 只传其中一个 |
| "relative_time 和 start_time/end_time 不能同时使用" | 时间参数冲突 | 选择一种时间过滤方式 |
| "未找到与 open_id=xxx 的单聊会话" | 没有单聊记录 | 改用 chat_id，或确认存在单聊 |
| 话题消息返回为空 | thread_id 格式不正确 | 确认为 omt_xxx 格式 |
| 图片/文件下载失败 | file_key 或 message_id 不匹配 | 确认 file_key 来自该 message_id |
| 权限不足 | 用户未授权或无权限 | 确认已完成 OAuth 授权且是会话成员 |
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.
日本語の概要は準備中です。原文の説明を表示しています。
Delegate coding tasks to Codex, Claude Code, or Pi agents via background process. Use when: (1) building/creating new features or apps, (2) reviewing PRs (spawn in temp dir), (3) refactoring large codebases, (4) iterative coding that needs file exploration. NOT for: simple one-liner fixes (just edit), reading code (use read tool), thread-bound ACP harness requests in chat (for example spawn/run Codex or Claude Code in a Discord thread; use sessions_spawn with runtime:"acp"), or any work in ~/clawd workspace (never spawn agents here). Claude Code: use --print --permission-mode bypassPermissions (no PTY). Codex/Pi/OpenCode: pty:true required.
日本語の概要は準備中です。原文の説明を表示しています。
Use when the user says "check Datadog", "查 Datadog", "查日志", "check logs", "crash logs", "查 crash", "gateway crash", "查告警", "check alerts", "check metrics", or needs to investigate production issues via Datadog Logs API.
日本語の概要は準備中です。原文の説明を表示しています。
深度调研方法论（8步法）：将模糊主题转化为高质量调研报告。 触发词：/deep-research、深度调研、帮我调研、调研一下、对比分析 注意：如果用户需要的是可视化图谱而非报告，请使用 research-to-diagram skill。
日本語の概要は準備中です。原文の説明を表示しています。
Send feedback to the Nexu team. Use when the user says /feedback followed by their message.
日本語の概要は準備中です。原文の説明を表示しています。
飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格
日本語の概要は準備中です。原文の説明を表示しています。