feishu-troubleshoot
飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令（/feishu_doctor）。 常见问题可随时查阅。诊断命令用于排查复杂问题（多次授权仍失败、自动授权无法解决等）， 会检查账户配置、API 连通性、应用权限、用户授权状态，并生成详细的诊断报告和解决方案。
Best use case
feishu-troubleshoot is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令（/feishu_doctor）。 常见问题可随时查阅。诊断命令用于排查复杂问题（多次授权仍失败、自动授权无法解决等）， 会检查账户配置、API 连通性、应用权限、用户授权状态，并生成详细的诊断报告和解决方案。
Teams using feishu-troubleshoot should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/feishu-troubleshoot/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How feishu-troubleshoot Compares
| Feature / Agent | feishu-troubleshoot | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令（/feishu_doctor）。 常见问题可随时查阅。诊断命令用于排查复杂问题（多次授权仍失败、自动授权无法解决等）， 会检查账户配置、API 连通性、应用权限、用户授权状态，并生成详细的诊断报告和解决方案。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 飞书插件问题排查 ## ❓ 常见问题（FAQ） ### 卡片按钮点击无反应 **现象**：点击卡片按钮后没有任何反应，然后提示报错. **原因**：应用未开通「消息卡片回传交互」权限。 **解决步骤**： 1. 登录飞书开放平台：https://open.feishu.cn/app 2. 选择您的应用 → **事件与回调** 3. 在回调配置中,修改订阅方式为"长链接"并添加回调 "卡片回传交互"(card.action.trigger) 4. 创建应用版本 → 提交审核 → 发布 --- ## 🔍 诊断命令（深度工具） **注意**：诊断命令仅用于排查复杂/疑难的**权限相关问题**。常规权限问题会自动触发授权流程，无需手动诊断。 **何时使用诊断**： - 多次授权后仍然报错 - 自动授权流程无法解决的问题 - 需要查看完整的权限配置状态 **使用方法**： 在飞书聊天会话中直接输入（作为用户消息发送）： /feishu doctor 诊断命令会检查： - **📋 诊断摘要**（首先展示）： - 总体状态（✅ 正常 / ⚠️ 警告 / ❌ 失败） - 发现的问题列表和简要描述 - **环境信息**： - 插件版本 - **账号信息**： - 凭证完整性（appId, appSecret 掩码） - 账户启用状态 - API 连通性测试 - Bot 信息（名称和 openId） - **应用身份权限**： - 应用已开通的必需权限数量 - 缺失的必需权限列表 - 一键申请链接（自动带上缺失权限参数） - **用户身份权限**： - 用户授权状态统计（✓ 有效 / ⟳ 需刷新 / ✗ 已过期） - Token 自动刷新状态（是否包含 offline_access） - 权限对照表（应用已开通 vs 用户已授权，逐项对比） - 应用权限缺失时的申请指引和链接 - 用户授权不足时的重新授权操作方法
Related Skills
feishu-update-doc
更新飞书云文档。支持 7 种更新模式：追加、覆盖、定位替换、全文替换、前/后插入、删除。
feishu-task
飞书任务管理工具,用于创建、查询、更新任务和清单。 **当以下情况时使用此 Skill**: (1) 需要创建、查询、更新、删除任务 (2) 需要创建、管理任务清单 (3) 需要查看任务列表或清单内的任务 (4) 用户提到"任务"、"待办"、"to-do"、"清单"、"task" (5) 需要设置任务负责人、关注人、截止时间
feishu-im-read
飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。 **当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息
feishu-fetch-doc
获取飞书云文档内容。返回文档的 Markdown 内容，支持处理文档中的图片、文件和画板（需配合 feishu_doc_media 工具）。
feishu-create-doc
创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档，支持指定创建位置（文件夹/知识库/知识空间）。
feishu-calendar
飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。
feishu-bitable
飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格
static-deploy
Deploy static pages to nexu.space. Use when user says deploy, publish, ship, or go live with a static site/page. Uploads files from workspace to <project-slug>.nexu.space via Wrangler + Cloudflare Pages. Supports first deploy and redeploy.
nano-banana
Generate or edit images via Nano Banana image models. Triggers on "generate image", "image generation", "nano banana", "edit image", "nano banana pro", "nano banana 2"
feedback
Send feedback to the Nexu team. Use when the user says /feedback followed by their message.
sync-specs
Use when code changes may have made documentation outdated, when reviewing docs for consistency, or when the user asks to sync or audit documentation.
nexu-e2e-test
Use when verifying OpenClaw gateway fixes end-to-end, testing skill loading after restart, or running integration tests against the local Nexu+OpenClaw stack. Triggers on "e2e test", "verify fix", "test gateway", "test skills loading".