Skip to content

docs: simplify lark base create guidance #459

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kongenpei wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: simplify lark base create guidance #459

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
36 changes: 36 additions & 0 deletions skills/lark-base/references/lark-base-base-create.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,42 @@ POST /open-apis/base/v3/bases
1. 先确认 Base 名称。
2. `--folder-token`、`--time-zone` 都是可选项；用户没要求时不要为此额外追问。
3. 创建成功后，整理并返回：Base 名称、token，以及响应中已有的可访问链接。
4. 创建成功时，只需说明：新 Base 里会自带 1 张默认空表，表内会预置 5-10 行空记录。
5. 把这张默认表视为“默认保留”；不要在创建成功这一轮立刻追问用户是否删除。
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Apr 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion | 🟠 Major

Duplicated guidance about not asking immediately after creation.

The same prohibition appears three times with only minor wording variations:

  • Line 70 (workflow): "不要在创建成功这一轮立刻追问用户是否删除"
  • Line 89 (禁止事项): "不要在刚创建 Base 后立刻追问是否删除"
  • Line 103 (注意事项): "不要在创建后立刻询问是否删除"

This contradicts the PR objective to "remove duplicated wording in the default-table deletion notes." Consider consolidating:

  • Keep the prohibition in line 89 (禁止事项 section) where it belongs with other "don't do" rules
  • Remove from line 70 since step 5 already says to treat the default table as "默认保留" (keep by default)
  • In line 103, reference the detailed rules above instead of repeating the prohibition
♻️ Suggested consolidation 
 3. 创建成功后,整理并返回:Base 名称、token,以及响应中已有的可访问链接。
 4. 创建成功时,只需说明:新 Base 里会自带 1 张默认空表,表内会预置 5-10 行空记录。
-5. 把这张默认表视为"默认保留";不要在创建成功这一轮立刻追问用户是否删除。
+5. 把这张默认表视为"默认保留"。

And simplify the notes section:

 ## 注意事项
 
-- 处理原则是"先告知、默认保留、触发后再问",不要在创建后立刻询问是否删除。
+- 处理原则是"先告知、默认保留、触发后再问";具体规则见上方"默认表删除决策规则"。
 - 即使用户已同意删除,也不要直接假设默认表的 `table_id` 或名称;先列出表,再基于真实返回结果删除。

This keeps the prohibition once in the 禁止事项 section where it logically belongs, and avoids repeating it in the workflow and notes.

Also applies to: 89-89, 103-103

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@skills/lark-base/references/lark-base-base-create.md` at line 70,
在文档中删除重复的“不在创建后立刻询问是否删除”的表述：保留该禁止规则仅在“禁止事项”（当前摘录处的行 89 所在段落，标识为禁止事项）并删除工作流步骤
5（标注为把默认表视为“默认保留”后紧跟的那句）和注意事项段落中重复的句子；在注意事项（当前行
103）改为一句简短的交叉引用，提示“关于创建后删除的禁止规则见禁止事项”，以避免重复并保持语义一致。


## 默认表删除决策规则

### 默认行为

- `+base-create` 完成后，默认动作只有“告知默认表存在”；不要主动发起删除讨论。
- 在满足触发条件前，始终把默认表视为保留状态。

### 触发条件

- 只有当用户后续已经明显把工作重心转到默认表之外时，才可以顺带询问默认表是否还需要保留。
- 可接受的触发信号只有这两类：
- 用户新增了其他表。
- 用户在非默认表里新增了字段、视图或记录。

### 禁止事项

- 不要因为“默认表看起来是空的”就主动建议删除。
- 不要在刚创建 Base 后立刻追问是否删除。
- 不要把“用户接下来可能不用它”当成删除信号。

### 删除前置条件

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

## 注意事项

- 处理原则是“先告知、默认保留、触发后再问”，不要在创建后立刻询问是否删除。
- 即使用户已同意删除，也不要直接假设默认表的 `table_id` 或名称；先列出表，再基于真实返回结果删除。

## 参考

Expand Down
Loading