54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
---
|
||
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
|
||
./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh list_tables <app_token>
|
||
```
|
||
### 2. 读取数据表记录
|
||
```bash
|
||
./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh list_records <app_token> <table_id> [page_size]
|
||
```
|
||
### 3. 新增记录
|
||
```bash
|
||
./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh create_record <app_token> <table_id> '{"字段名1":"值1","字段名2":"值2"}'
|
||
```
|
||
### 4. 更新记录
|
||
```bash
|
||
./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh update_record <app_token> <table_id> <record_id> '{"字段名1":"新值"}'
|
||
```
|
||
### 5. 删除记录
|
||
```bash
|
||
./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh delete_record <app_token> <table_id> <record_id>
|
||
```
|
||
## 完整执行流程
|
||
1. 自动获取Bot租户访问凭证（有效期2小时，自动复用）
|
||
2. 调用对应飞书OpenAPI执行操作
|
||
3. 处理返回结果，结构化输出给用户 |