From 9382c56db52fe60f7a1313be38153f8d861121af Mon Sep 17 00:00:00 2001 From: liuyunwei Date: Thu, 9 Apr 2026 18:25:51 +0800 Subject: [PATCH 1/3] feat(skills): proactive whiteboard discovery when creating documents MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Users rarely mention "画板" explicitly, but their document topics (architecture, workflows, org charts, timelines, etc.) naturally call for visual diagrams. This change makes the AI proactively identify such content and create whiteboards without waiting for the user to ask. - lark-doc/SKILL.md: add whiteboard demand discovery section with semantic-to-diagram-type mapping table - lark-doc-create.md: add "主动画板" writing principle and scene entry - lark-whiteboard/SKILL.md: rewrite description from tool-centric to intent-centric, clarify boundary with lark-doc Co-Authored-By: Claude Opus 4.6 (1M context) --- skills/lark-doc/SKILL.md | 23 +++++++++++++++++++ skills/lark-doc/references/lark-doc-create.md | 2 ++ skills/lark-whiteboard/SKILL.md | 3 ++- 3 files changed, 27 insertions(+), 1 deletion(-) diff --git a/skills/lark-doc/SKILL.md b/skills/lark-doc/SKILL.md index ca3b35de..bdae48be 100644 --- a/skills/lark-doc/SKILL.md +++ b/skills/lark-doc/SKILL.md @@ -126,6 +126,29 @@ Drive Folder (云空间文件夹) - `docs +search` 不是只搜文档 / Wiki；结果里会直接返回 `SHEET` 等云空间对象。 - 拿到 spreadsheet URL / token 后，再切到 `lark-sheets` 做对象内部读取、筛选、写入等操作。 +## 画板需求挖掘（主动识别） + +> **用户很少主动提”画板”。创建文档时应主动识别适合可视化的内容，用画板呈现。** + +创建/编辑文档时，文档主题涉及以下语义，应**主动**创建画板，无需用户指定： + +| 语义 | 画板类型 | +|------|---------| +| 架构/分层/技术方案 | 架构图 | +| 流程/审批/部署/业务流转 | 流程图（Mermaid） | +| 组织/层级/汇报关系 | 组织架构图 | +| 时间线/里程碑/版本规划 | 里程碑图 | +| 因果/复盘/根因分析 | 鱼骨图 | +| 方案对比/技术选型 | 对比图 | +| 循环/飞轮/闭环 | 飞轮图 | +| 层级占比/能力模型 | 金字塔图 | +| 模块依赖/调用关系 | 架构图 | +| 分类梳理/知识体系 | 思维导图（Mermaid） | + +**执行**：`docs +create` 含空白画板占位 → 取 `board_tokens` → 切 [`lark-whiteboard`](../lark-whiteboard/SKILL.md) 编辑。画板数量不限，但每个画板应承载足够的信息量，避免内容过于单薄。 + +**不适用**：纯文字记录（纪要/周报/日志）、数据密集型内容（用表格）、用户明确只要文字。 + ## 补充说明 `docs +search` 除了搜索文档 / Wiki，也承担“先定位云空间对象，再切回对应业务 skill 操作”的资源发现入口角色；当用户口头说“表格 / 报表”时，也优先从这里开始。 diff --git a/skills/lark-doc/references/lark-doc-create.md b/skills/lark-doc/references/lark-doc-create.md index fca09839..cec98f8d 100644 --- a/skills/lark-doc/references/lark-doc-create.md +++ b/skills/lark-doc/references/lark-doc-create.md @@ -68,6 +68,7 @@ lark-cli docs +create --title "学习笔记" --wiki-space my_library --markdown - **结构清晰**：标题层级 ≤ 4 层，用 Callout 突出关键信息 - **视觉节奏**：用分割线、分栏、表格打破大段纯文字 - **图文交融**：流程、架构或草图需要可视化时，优先使用图片、表格或空白画板 +- **主动画板**：文档涉及架构、流程、组织、时间线、因果等逻辑关系时，主动插入空白画板，后续用 lark-whiteboard 填充。详见 [画板需求挖掘](../SKILL.md#画板需求挖掘主动识别) - **克制留白**：Callout 不过度、加粗只强调核心词 当用户有明确的样式、风格需求时，应当以用户的需求为准！ @@ -633,6 +634,7 @@ $$ | 知识卡片 | Callout + emoji | 用于概念解释、小贴士 | | 引用说明 | 引用块 > | 引用原文、名言 | | 术语对照 | 两列表格 | 中英文、缩写全称等 | +| 架构/流程/组织/时间线/因果 | **空白画板** | 主动插入，用 lark-whiteboard 绘制 | --- diff --git a/skills/lark-whiteboard/SKILL.md b/skills/lark-whiteboard/SKILL.md index 0bd7777e..d8e7995a 100644 --- a/skills/lark-whiteboard/SKILL.md +++ b/skills/lark-whiteboard/SKILL.md @@ -1,7 +1,8 @@ --- name: lark-whiteboard description: > - 当用户要求在飞书云文档中绘制图表，或使用飞书画板绘制架构图、流程图、思维导图、时序图或其他可视化图表时使用此 skill。 + 当用户需要可视化表达架构、流程、组织关系、时间线、因果、对比等结构化信息时使用此 skill，无论是否提及"画板"。 + 如果用户主要意图是创建文档（可能含画板），应由 lark-doc 主导并联动本 skill。 compatibility: Requires Node.js 18+ metadata: requires: From fadad25fb6906cd29b83035630f1ba3a1a71422d Mon Sep 17 00:00:00 2001 From: liuyunwei Date: Thu, 9 Apr 2026 18:39:36 +0800 Subject: [PATCH 2/3] fix: address review feedback on whiteboard discovery - Execution flow: mention both docs +create and docs +update, clarify board_tokens comes from docs +update response - Add guard clauses to proactive whiteboard rules (skip when user explicitly wants text-only or content suits tables better) Co-Authored-By: Claude Opus 4.6 (1M context) --- skills/lark-doc/SKILL.md | 2 +- skills/lark-doc/references/lark-doc-create.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/skills/lark-doc/SKILL.md b/skills/lark-doc/SKILL.md index bdae48be..30540217 100644 --- a/skills/lark-doc/SKILL.md +++ b/skills/lark-doc/SKILL.md @@ -145,7 +145,7 @@ Drive Folder (云空间文件夹) | 模块依赖/调用关系 | 架构图 | | 分类梳理/知识体系 | 思维导图（Mermaid） | -**执行**：`docs +create` 含空白画板占位 → 取 `board_tokens` → 切 [`lark-whiteboard`](../lark-whiteboard/SKILL.md) 编辑。画板数量不限，但每个画板应承载足够的信息量，避免内容过于单薄。 +**执行**：创建场景用 `docs +create`、编辑场景用 `docs +update` 插入空白画板占位 → 从 `docs +update` 响应的 `data.board_tokens` 获取画板 token → 切 [`lark-whiteboard`](../lark-whiteboard/SKILL.md) 编辑。画板数量不限，但每个画板应承载足够的信息量，避免内容过于单薄。 **不适用**：纯文字记录（纪要/周报/日志）、数据密集型内容（用表格）、用户明确只要文字。 diff --git a/skills/lark-doc/references/lark-doc-create.md b/skills/lark-doc/references/lark-doc-create.md index cec98f8d..d810b62d 100644 --- a/skills/lark-doc/references/lark-doc-create.md +++ b/skills/lark-doc/references/lark-doc-create.md @@ -68,7 +68,7 @@ lark-cli docs +create --title "学习笔记" --wiki-space my_library --markdown - **结构清晰**：标题层级 ≤ 4 层，用 Callout 突出关键信息 - **视觉节奏**：用分割线、分栏、表格打破大段纯文字 - **图文交融**：流程、架构或草图需要可视化时，优先使用图片、表格或空白画板 -- **主动画板**：文档涉及架构、流程、组织、时间线、因果等逻辑关系时，主动插入空白画板，后续用 lark-whiteboard 填充。详见 [画板需求挖掘](../SKILL.md#画板需求挖掘主动识别) +- **主动画板**：文档涉及架构、流程、组织、时间线、因果等逻辑关系时，主动插入空白画板，后续用 lark-whiteboard 填充；但若用户明确要求仅文本或内容更适合表格，则不插入。详见 [画板需求挖掘](../SKILL.md#画板需求挖掘主动识别) - **克制留白**：Callout 不过度、加粗只强调核心词 当用户有明确的样式、风格需求时，应当以用户的需求为准！ @@ -634,7 +634,7 @@ $$ | 知识卡片 | Callout + emoji | 用于概念解释、小贴士 | | 引用说明 | 引用块 > | 引用原文、名言 | | 术语对照 | 两列表格 | 中英文、缩写全称等 | -| 架构/流程/组织/时间线/因果 | **空白画板** | 主动插入，用 lark-whiteboard 绘制 | +| 架构/流程/组织/时间线/因果 | **空白画板** | 主动插入，用 lark-whiteboard 绘制（用户明确仅文本或数据密集表格场景除外） | --- From df1a2d0e3339c6f543b6bd97f06718ea53fcc325 Mon Sep 17 00:00:00 2001 From: liuyunwei Date: Thu, 9 Apr 2026 18:46:03 +0800 Subject: [PATCH 3/3] fix: remove meeting notes and weekly report from whiteboard exclusions Meeting notes and weekly reports can benefit from whiteboards (e.g., timeline of action items, discussion flow). Only exclude pure text logs/memos and data-dense tabular content. Co-Authored-By: Claude Opus 4.6 (1M context) --- 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 30540217..02ce9eba 100644 --- a/skills/lark-doc/SKILL.md +++ b/skills/lark-doc/SKILL.md @@ -147,7 +147,7 @@ Drive Folder (云空间文件夹) **执行**：创建场景用 `docs +create`、编辑场景用 `docs +update` 插入空白画板占位 → 从 `docs +update` 响应的 `data.board_tokens` 获取画板 token → 切 [`lark-whiteboard`](../lark-whiteboard/SKILL.md) 编辑。画板数量不限，但每个画板应承载足够的信息量，避免内容过于单薄。 -**不适用**：纯文字记录（纪要/周报/日志）、数据密集型内容（用表格）、用户明确只要文字。 +**不适用**：纯文字记录（日志/备忘）、数据密集型内容（用表格）、用户明确只要文字。 ## 补充说明 `docs +search` 除了搜索文档 / Wiki，也承担“先定位云空间对象，再切回对应业务 skill 操作”的资源发现入口角色；当用户口头说“表格 / 报表”时，也优先从这里开始。