Skip to content

docs(lark-doc): add shared edit safety guidance #2561

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
ArminStoic wants to merge 5 commits into
base: main
Choose a base branch
from
+3 −1
Open

docs(lark-doc): add shared edit safety guidance #2561

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
e206557
docs(lark-doc): add shared edit safety rule
ArminStoic Aug 29, 2026
af7783e
docs(lark-doc): document stale-write safeguards
ArminStoic Aug 29, 2026
4538284
docs(lark-doc): bind updates to fetched revisions
ArminStoic Aug 29, 2026
952529a
docs(lark-doc): surface revision binding in edit guidance
ArminStoic Aug 29, 2026
3fa96ea
docs(lark-doc): restore minimum edit scope guidance
ArminStoic Aug 29, 2026
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
2 changes: 1 addition & 1 deletion skills/lark-doc/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ metadata:
- **读取 / 摘要 — [`+fetch`](references/lark-doc-fetch.md)**：先读参考再获取文档。
- **从零创作 — [`创建工作流`](references/lark-doc-create-workflow.md)**：先完整执行创建工作流，**简单任务不是跳过的理由**；
- **导入 / 空文档 — [`+create`](references/lark-doc-create.md)**：仅创建空文档或原样导入用户提供的完整内容时，跳过创建工作流。
- **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。
- **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。编辑用户可能同步维护的已有文档时，每次写入前重新局部读取目标内容及最新 revision，并用本次读取的 revision ID 约束对应写入；若发生版本冲突，重新读取并基于最新内容生成修改。始终只修改用户本轮明确指定的最小范围。

### 辅助能力

Expand Down
2 changes: 2 additions & 0 deletions skills/lark-doc/references/lark-doc-update.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,8 @@ lark-cli docs +update --doc "xx" --command block_delete --start-block-id blkFirs

## 通用安全规则

- 对用户可能同步维护的已有文档，每次写操作前重新局部 fetch 目标内容、block ID 和最新 revision，并在对应写操作中通过 `--revision-id` 显式传入本次 fetch 返回的 revision ID，不要依赖默认值 `-1`。若发生版本冲突，重新 fetch 最新内容，基于新版本重新生成局部修改后再重试。
- 只修改用户本轮明确授权的最小范围，不要顺带调整未请求的结构、措辞或相邻内容；仅当用户明确要求整体重建时才使用 `overwrite`。
- 每次写操作后都按 block ID 已变化处理。新插入或复制的内容一定使用新 ID；替换、删除和覆盖会使旧 ID 失效；移动会改变章节与 range 语义。
- 同一 block 有多处修改时，应合并为一次 `block_replace`，避免连续使用旧 ID。

Expand Down
Loading