Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions skills/lark-base/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -282,15 +282,25 @@ metadata:
11. workflow 场景先读 schema,不要凭自然语言猜 `type`。
12. dashboard 场景先读 guide;提到图表、看板、block 就先进入 dashboard 模块。
13. formula / lookup 场景先读 guide;没读 guide 前不要直接创建或更新。
14. 新建 Base 后,如果后续又新增了非默认表,或在非默认表里新增了字段、视图、记录,则最终回复里必须单独追加一句默认空表去留澄清:`下一步如果你不打算保留初始默认表,我可以继续帮你删掉;要我现在继续吗?`

### 4.3 并发、分页与批量限制
### 4.3 新建 Base 收尾检查

只要当前会话里刚创建过 Base,且后续继续操作了非默认表,最终回复前都必须做这一步自检:

1. 是否已经创建了新的非默认表,或在非默认表里继续新增字段、视图、记录。
2. 如果是,结果汇总后单独补一句默认空表去留澄清。
3. 不要把这句澄清埋进表格、长段落或“如有需要”这种泛化收尾里。
4. 没有补这句澄清时,不要结束回复。

### 4.4 并发、分页与批量限制

- `+table-list / +field-list / +record-list / +view-list / +record-history-list / +role-list / +dashboard-list / +dashboard-block-list / +workflow-list` 禁止并发调用,只能串行执行。
- `+record-list` 分页时,`--limit` 最大 `200`;先拉首批并检查 `has_more`,只有用户明确需要更多数据时再继续翻页。
- 批量写入时,单批建议不超过 `500` 条。
- 连续写入同一表时,建议串行写入,批次间延迟 `0.5–1` 秒。

### 4.4 确认与回复规则
### 4.5 确认与回复规则

- 视图重命名时,用户已明确“把哪个视图改成什么名字”时,`+view-rename` 直接执行即可。
- 删除记录 / 字段 / 表时,如果用户已经明确说要删除,且目标明确,`+record-delete / +field-delete / +table-delete` 可直接执行,并带 `--yes`。
Expand Down
33 changes: 33 additions & 0 deletions skills/lark-base/references/lark-base-base-create.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,39 @@ POST /open-apis/base/v3/bases
1. 先确认 Base 名称。
2. `--folder-token`、`--time-zone` 都是可选项;用户没要求时不要为此额外追问。
3. 创建成功后,整理并返回:Base 名称、token,以及响应中已有的可访问链接。
4. 创建成功时,只需说明:新 Base 里会自带 1 张默认空表,表内会预置 5-10 行空记录。

## 默认表删除决策规则

### 触发条件

- 一旦命中下述任一触发信号,必须主动澄清默认表是否需要删除。
- 可以先用 1-2 句交代刚完成的结果;紧接着下一句单独发问,不要埋在长段落里。
- 可接受的触发信号只有这两类:
- 用户新增了其他表。
- 用户在非默认表里新增了字段、视图或记录。

### 推荐话术

- 推荐直接问:`下一步如果你不打算保留初始默认表,我可以继续帮你删掉;要我现在继续吗?`

### 禁止事项

- 不要在刚创建 Base 后立刻追问是否删除。
- 不要把“用户接下来可能不用它”当成删除信号。

### 删除前置条件

- 只有同时满足以下条件,才可以进入删除流程:
- 已满足上面的触发条件。
- 用户已明确表示要删除默认表。
- `+table-list` 已确认当前 Base 内的真实表列表,并能明确识别删除目标。
- 缺少任一条件时,都不要执行删除。
- 删除目标确认后,才继续走 `+table-delete`。

## 注意事项

- 即使用户已同意删除,也不要直接假设默认表的 `table_id` 或名称;先列出表,再基于真实返回结果删除。

## 参考

Expand Down
3 changes: 3 additions & 0 deletions skills/lark-base/references/lark-base-table-create.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,9 @@ POST /open-apis/base/v3/bases/:base_token/tables
- 至少返回 `table`。
- 传了 `--fields` / `--view` 时,还会附带 `fields` / `views`。

> [!IMPORTANT]
> 如果这次是在刚创建的新 Base 里新增非默认表,返回建表成功后,必须主动澄清默认空表是否保留,例如:`下一步如果你不打算保留初始默认表,我可以继续帮你删掉;要我现在继续吗?`

## 工作流


Expand Down
Loading