核心用法
本 Skill 专为解决飞书多维表格操作中常见的 token 混淆问题而设计。Agent 在使用 feishu_bitable_* 工具时，常因直接将 wiki 链接中的 node_token 误作 app_token 而导致 91402 NOTEXIST 错误。本 Skill 强制要求始终先调用 `feishu_bitable_get_meta` 解析 URL，获取真实的 app_token 后再执行后续操作。
标准操作流程：
1. 解析 URL → 获取 app_token 和 table_id
2. 查询字段结构 → 确认字段名和类型
3. 执行 CRUD → 创建、读取、更新或删除记录
支持两种 URL 格式：
- Base 直链：
/base/AppToken（可直接提取） - Wiki 嵌入：
/wiki/NodeToken（必须解析转换）
显著优点
- 错误预防：强制前置校验，根治 91402 token 错误
- 双格式兼容：自动处理 wiki 和 base 两种链接场景
- 完整字段支持：涵盖文本、数字、单选、多选、日期、人员、附件等 17 种字段类型
- 权限清晰：明确列出所需的飞书开放平台权限（
bitable:app、wiki:wiki:readonly等）
潜在局限
- 依赖外部服务：需飞书插件已配置且权限开通，否则完全不可用
- 附件限制：Attachment 类型字段不支持直接写入
- 版本耦合：与飞书 OpenAPI 版本绑定，接口变更时需同步更新
适合人群
- 需要让 Agent 自动读写飞书多维表格的开发者
- 使用飞书知识库嵌入表格、频繁遇到 91402 错误的团队
- 构建自动化数据录入、报表同步、CRM 管理等场景的集成需求
常规风险
- 权限泄露风险：
app_token和appSecret需妥善保管，避免硬编码泄露 - 数据误操作：Agent 具备写权限，建议配合字段校验和审计日志使用
- Rate Limit：高频调用可能触发飞书 API 限流，需合理控制请求频率