lark_bitable_operate_as_bot.vala/SKILL.md

name	version	description	metadata
lark_bitable_operate_as_bot	1.0.0	飞书多维表格Bot身份操作专用技能，统一使用Bot身份读取、编辑多维表格记录，禁止触发用户身份授权	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. 列出多维表格所有数据表

./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh list_tables <app_token>

2. 读取数据表记录

./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh list_records <app_token> <table_id> [page_size]

3. 新增记录

./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh create_record <app_token> <table_id> '{"字段名1":"值1","字段名2":"值2"}'

4. 更新记录

./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh update_record <app_token> <table_id> <record_id> '{"字段名1":"新值"}'

5. 删除记录

./skills/lark_bitable_operate_as_bot/scripts/operate_bitable.sh delete_record <app_token> <table_id> <record_id>

完整执行流程

1. 自动获取Bot租户访问凭证（有效期2小时，自动复用）
2. 调用对应飞书OpenAPI执行操作
3. 处理返回结果，结构化输出给用户