fix: whiteboard skill (#1166)

Change-Id: Ib1da37c1520d7697eaee7146555185ffbc749217

skills/lark-whiteboard/SKILL.md

@@ -31,10 +31,6 @@ metadata:
 | 绘制复杂图表（架构/流程/组织等）| → **[§ 创作 Workflow](#创作-workflow)** |
 | 修改/重绘已有复杂画板 | → **[§ 修改 Workflow](#修改-workflow)** |
 
-> **⚠️ 强制规范（通过 stdin 更新）**：
-> 数据来源于本地文件时，**必须**使用 `--source - --input_format <格式>`。
-> 例：`cat chart.mmd | lark-cli whiteboard +update <token> --source - --input_format mermaid`
-
 ## Shortcuts
 
 | Shortcut | 说明 |
@@ -54,7 +50,7 @@ metadata:
 | 用户给了什么 | 怎么获取 |
 |---|---|
 | 直接给了 whiteboard token（`wbcnXXX`）| 直接使用 |
-| 文档 URL 或 doc_id，文档中已有画板 | `lark-cli docs +fetch --api-version v2 --doc <URL> --as user`，从返回的 `<whiteboard token="xxx"/>` 提取 |
+| 文档 URL 或 doc_id，文档中已有画板 | `lark-cli docs +fetch --doc <URL> --as user`，从返回的 `<whiteboard token="xxx"/>` 提取 |
 | 文档 URL 或 doc_id，需要新建画板 | `lark-cli docs +update --api-version v2 --doc <doc_id> --command append --content '<whiteboard type="blank"></whiteboard>' --as user`，从响应 `data.new_blocks[0].block_token` 取得（`block_type == "whiteboard"` 的那条；参数详见 lark-doc SKILL.md）|
 
 **Step 2：渲染 & 写入**
@@ -89,11 +85,11 @@ metadata:
 
 **然后按图表类型 × 身份选路径**，读对应文件按其完整 workflow 执行（含读 scene 指南、生成内容、渲染审查、交付）：
 
-| 图表类型 | 身份 | 路径 |
-|---|---|---|
-| 思维导图、时序图、类图、饼图、甘特图 | 任何身份 | [`routes/mermaid.md`](routes/mermaid.md) |
-| 其他图表 | `Claude` / `Gemini` / `GPT` / `GLM` | [`routes/svg.md`](routes/svg.md) |
-| 其他图表 | `Doubao` / `Seed` / `Other` | [`routes/dsl.md`](routes/dsl.md) |
+| 图表类型                   | 身份                                  | 路径                                       |
+|------------------------|-------------------------------------|------------------------------------------|
+| 思维导图、流程图、时序图、类图、饼图、甘特图 | 任何身份                                | [`routes/mermaid.md`](routes/mermaid.md) |
+| 其他图表                   | `Claude` / `Gemini` / `GPT` / `GLM` | [`routes/svg.md`](routes/svg.md)         |
+| 其他图表                   | `Doubao` / `Seed` / `Other`         | [`routes/dsl.md`](routes/dsl.md)         |
 
 > **⚠️ SVG 路径失败回退**：走 `routes/svg.md` 时，碰到以下情况之一 → **丢弃当前 SVG，改读 `routes/dsl.md` 从零重画，不要逐行修补**：
 > - 渲染命令直接报错（语法级崩溃，不是 `--check` 的 warn/error）
@@ -118,26 +114,18 @@ diagram.png           ← 渲染结果
 
 ### 写入画板
 
-> [!CAUTION]
-> **写入前强制 dry-run**：向已有内容的画板写入时，必须先加 `--overwrite --dry-run` 探测。
-> 输出含 `XX whiteboard nodes will be deleted` → 必须向用户确认后才能执行。
+> 关于 --overwrite
+> 画板更新命令中，若不携带 --overwrite flag，则是增量更新画板内容，若画板内已有内容的话，新增内容可能会和已有内容重叠，导致问题。
+> 因此，若需要整体更新画板内容，需携带 --overwrite flag 覆盖式更新。
 
 ```bash
-# 第一步：dry-run 探测
 npx -y @larksuite/whiteboard-cli@^0.2.11 -i <产物文件> --to openapi --format json \
   | lark-cli whiteboard +update \
     --whiteboard-token <Token> \
     --source - --input_format raw \
     --idempotent-token <10+字符唯一串> \
-    --overwrite --dry-run --as user
-
-# 第二步：确认后执行
-npx -y @larksuite/whiteboard-cli@^0.2.11 -i <产物文件> --to openapi --format json \
-  | lark-cli whiteboard +update \
-    --whiteboard-token <Token> \
-    --source - --input_format raw \
-    --idempotent-token <10+字符唯一串> \
-    --overwrite --as user
+    --as user \
+    --overwrite
 ```
 
 > `--idempotent-token` 最少 10 字符，建议用时间戳+标识拼接（如 `1744800000-board-1`），避免重试导致重复写入。

skills/lark-whiteboard/references/lark-whiteboard-update.md

@@ -54,10 +54,10 @@ cat diagram.puml | lark-cli whiteboard +update \
 # 编写 Mermaid 代码
 cat > diagram.mmd << 'EOF'
 graph TD
-    A[开始] --&gt; B{判断}
-    B --&gt;|是| C[处理]
-    B --&gt;|否| D[结束]
-    C --&gt; D
+    A[开始] --> B{判断}
+    B -->|是| C[处理]
+    B -->|否| D[结束]
+    C --> D
 EOF
 
 # 从文件读取并更新