---
name: lark_bitable_operate_as_bot
version: 1.0.0
description: "飞书多维表格Bot身份操作专用技能，统一使用Bot身份读取、编辑多维表格记录，禁止触发用户身份授权"
metadata:
  requires:
    permissions: ["bitable:app", "base:record:retrieve", "base:record:create", "base:record:update", "base:record:delete"]
---
# lark_bitable_operate_as_bot 技能规范
## 核心规则（强制执行）
1. **身份限制**：所有多维表格操作**永远使用Bot身份**执行，绝对不触发任何用户身份授权弹窗
2. **权限告知规则**：
   - Bot无权限访问目标多维表格：回复「当前Bot无访问该多维表格权限，请将Bot应用（App ID: `cli_a931175d41799cc7`）添加为多维表格协作者并授予对应权限后重试」
   - 权限不足时提示需要开通的权限：`bitable:app`、`base:record:retrieve`、`base:record:create`等
## 支持操作
- ✅ 读取多维表格记录
- ✅ 新增单条/多条记录
- ✅ 更新已有记录
- ✅ 删除记录
- ✅ 列出多维表格所有数据表
## 参数说明
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| action | string | 是 | 操作类型：`list_tables`/`list_records`/`create_record`/`update_record`/`delete_record` |
| app_token | string | 是 | 多维表格app_token，从链接中提取 |
| table_id | string | 否 | 数据表ID，`list_tables`时不需要，其他操作必填 |
| record_id | string | 否 | 记录ID，`update_record`/`delete_record`时必填 |
| fields | object | 否 | 记录字段内容，`create_record`/`update_record`时必填 |
| page_size | number | 否 | 读取记录数量，默认50，最大500 |
## 使用示例
### 1. 列出多维表格所有数据表
```bash
./business_production/_shared/lark_bitable_operate_as_bot/scripts/operate_bitable.sh list_tables <app_token>
```
### 2. 读取数据表记录
```bash
./business_production/_shared/lark_bitable_operate_as_bot/scripts/operate_bitable.sh list_records <app_token> <table_id> [page_size]
```
### 3. 新增记录
```bash
./business_production/_shared/lark_bitable_operate_as_bot/scripts/operate_bitable.sh create_record <app_token> <table_id> '{"字段名1":"值1","字段名2":"值2"}'
```
### 4. 更新记录
```bash
./business_production/_shared/lark_bitable_operate_as_bot/scripts/operate_bitable.sh update_record <app_token> <table_id> <record_id> '{"字段名1":"新值"}'
```
### 5. 删除记录
```bash
./business_production/_shared/lark_bitable_operate_as_bot/scripts/operate_bitable.sh delete_record <app_token> <table_id> <record_id>
```
## 完整执行流程
1. 自动获取Bot租户访问凭证（有效期2小时，自动复用）
2. 调用对应飞书OpenAPI执行操作
3. 处理返回结果，结构化输出给用户