From e20655706d0ec13a25e03facf155d77089597b3e Mon Sep 17 00:00:00 2001 From: armin <273827089+Armin-Y@users.noreply.github.com> Date: Sat, 29 Aug 2026 17:59:01 +0800 Subject: [PATCH 1/5] docs(lark-doc): add shared edit safety rule Clarify the editing process for existing documents by specifying the need to read the latest revision before writing. --- skills/lark-doc/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/lark-doc/SKILL.md b/skills/lark-doc/SKILL.md index 5d086f3611..d1d5255c50 100644 --- a/skills/lark-doc/SKILL.md +++ b/skills/lark-doc/SKILL.md @@ -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，并且只修改用户本轮明确指定的最小范围。 ### 辅助能力 From af7783ebaa73e675ad81cc43ee30ff80e1e21031 Mon Sep 17 00:00:00 2001 From: armin <273827089+Armin-Y@users.noreply.github.com> Date: Sat, 29 Aug 2026 17:59:37 +0800 Subject: [PATCH 2/5] docs(lark-doc): document stale-write safeguards Update general security rules for document synchronization and modification. --- skills/lark-doc/references/lark-doc-update.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/skills/lark-doc/references/lark-doc-update.md b/skills/lark-doc/references/lark-doc-update.md index 18234c8d32..d337da573a 100644 --- a/skills/lark-doc/references/lark-doc-update.md +++ b/skills/lark-doc/references/lark-doc-update.md @@ -75,6 +75,8 @@ lark-cli docs +update --doc "xx" --command block_delete --start-block-id blkFirs ## 通用安全规则 +- 对用户可能同步维护的已有文档，每次写操作前都重新局部 fetch 目标内容、block ID 和可用的最新 revision。若内容较先前读取结果已经变化，基于最新内容重新生成局部修改，不要沿用早期正文或 revision 重写目标章节。 +- 只修改用户本轮明确授权的最小范围，不要顺带调整未请求的结构、措辞或相邻内容；仅当用户明确要求整体重建时才使用 `overwrite`。 - 每次写操作后都按 block ID 已变化处理。新插入或复制的内容一定使用新 ID；替换、删除和覆盖会使旧 ID 失效；移动会改变章节与 range 语义。 - 同一 block 有多处修改时，应合并为一次 `block_replace`，避免连续使用旧 ID。 From 45382843a4998653e51eb1604fe3ab95c53cf55b Mon Sep 17 00:00:00 2001 From: armin <273827089+Armin-Y@users.noreply.github.com> Date: Sat, 29 Aug 2026 18:19:30 +0800 Subject: [PATCH 3/5] docs(lark-doc): bind updates to fetched revisions Require each write to pass the revision ID returned by the preceding fetch. On a version conflict, fetch the latest content, regenerate the scoped change, and retry. --- skills/lark-doc/references/lark-doc-update.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/lark-doc/references/lark-doc-update.md b/skills/lark-doc/references/lark-doc-update.md index d337da573a..5357e30ac4 100644 --- a/skills/lark-doc/references/lark-doc-update.md +++ b/skills/lark-doc/references/lark-doc-update.md @@ -75,7 +75,7 @@ lark-cli docs +update --doc "xx" --command block_delete --start-block-id blkFirs ## 通用安全规则 -- 对用户可能同步维护的已有文档，每次写操作前都重新局部 fetch 目标内容、block ID 和可用的最新 revision。若内容较先前读取结果已经变化，基于最新内容重新生成局部修改，不要沿用早期正文或 revision 重写目标章节。 +- 对用户可能同步维护的已有文档，每次写操作前重新局部 fetch 目标内容、block ID 和最新 revision，并在对应写操作中通过 `--revision-id` 显式传入本次 fetch 返回的 revision ID，不要依赖默认值 `-1`。若发生版本冲突，重新 fetch 最新内容，基于新版本重新生成局部修改后再重试。 - 只修改用户本轮明确授权的最小范围，不要顺带调整未请求的结构、措辞或相邻内容；仅当用户明确要求整体重建时才使用 `overwrite`。 - 每次写操作后都按 block ID 已变化处理。新插入或复制的内容一定使用新 ID；替换、删除和覆盖会使旧 ID 失效；移动会改变章节与 range 语义。 - 同一 block 有多处修改时，应合并为一次 `block_replace`，避免连续使用旧 ID。 From 952529aaa8fcea2258a915e88e5ef792f9b6ee88 Mon Sep 17 00:00:00 2001 From: armin <273827089+Armin-Y@users.noreply.github.com> Date: Sat, 29 Aug 2026 18:21:35 +0800 Subject: [PATCH 4/5] docs(lark-doc): surface revision binding in edit guidance Update the lark-doc edit entry point to require each write to use the revision ID returned by the latest fetch. Regenerate the scoped change from fresh content after a version conflict. --- skills/lark-doc/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/lark-doc/SKILL.md b/skills/lark-doc/SKILL.md index d1d5255c50..40a586b385 100644 --- a/skills/lark-doc/SKILL.md +++ b/skills/lark-doc/SKILL.md @@ -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 参考完成。编辑用户可能同步维护的已有文档时，每次写入前重新局部读取目标内容及可用的最新 revision，并且只修改用户本轮明确指定的最小范围。 +- **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。编辑用户可能同步维护的已有文档时，每次写入前重新局部读取目标内容及最新 revision，并用本次读取的 revision ID 约束对应写入；若发生版本冲突，重新读取并基于最新内容生成修改。 ### 辅助能力 From 3fa96ea8e9a9313e46308a2fa6cbc32eeb44095d Mon Sep 17 00:00:00 2001 From: armin <273827089+Armin-Y@users.noreply.github.com> Date: Sat, 29 Aug 2026 18:29:10 +0800 Subject: [PATCH 5/5] docs(lark-doc): restore minimum edit scope guidance Restore the entry-point requirement to limit document updates to the scope explicitly authorized by the user while retaining the revision-bound write guidance. --- skills/lark-doc/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/lark-doc/SKILL.md b/skills/lark-doc/SKILL.md index 40a586b385..71383c6932 100644 --- a/skills/lark-doc/SKILL.md +++ b/skills/lark-doc/SKILL.md @@ -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 参考完成。编辑用户可能同步维护的已有文档时，每次写入前重新局部读取目标内容及最新 revision，并用本次读取的 revision ID 约束对应写入；若发生版本冲突，重新读取并基于最新内容生成修改。 +- **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。编辑用户可能同步维护的已有文档时，每次写入前重新局部读取目标内容及最新 revision，并用本次读取的 revision ID 约束对应写入；若发生版本冲突，重新读取并基于最新内容生成修改。始终只修改用户本轮明确指定的最小范围。 ### 辅助能力