diff --git a/skills/lark-doc/SKILL.md b/skills/lark-doc/SKILL.md index ca3b35de..02ce9eba 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`、编辑场景用 `docs +update` 插入空白画板占位 → 从 `docs +update` 响应的 `data.board_tokens` 获取画板 token → 切 [`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..d810b62d 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: