Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
23 changes: 23 additions & 0 deletions skills/lark-doc/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 操作”的资源发现入口角色;当用户口头说“表格 / 报表”时,也优先从这里开始。

Expand Down
2 changes: 2 additions & 0 deletions skills/lark-doc/references/lark-doc-create.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,7 @@ lark-cli docs +create --title "学习笔记" --wiki-space my_library --markdown
- **结构清晰**:标题层级 ≤ 4 层,用 Callout 突出关键信息
- **视觉节奏**:用分割线、分栏、表格打破大段纯文字
- **图文交融**:流程、架构或草图需要可视化时,优先使用图片、表格或空白画板
- **主动画板**:文档涉及架构、流程、组织、时间线、因果等逻辑关系时,主动插入空白画板,后续用 lark-whiteboard 填充;但若用户明确要求仅文本或内容更适合表格,则不插入。详见 [画板需求挖掘](../SKILL.md#画板需求挖掘主动识别)
- **克制留白**:Callout 不过度、加粗只强调核心词

当用户有明确的样式、风格需求时,应当以用户的需求为准!
Expand Down Expand Up @@ -633,6 +634,7 @@ $$
| 知识卡片 | Callout + emoji | 用于概念解释、小贴士 |
| 引用说明 | 引用块 > | 引用原文、名言 |
| 术语对照 | 两列表格 | 中英文、缩写全称等 |
| 架构/流程/组织/时间线/因果 | **空白画板** | 主动插入,用 lark-whiteboard 绘制(用户明确仅文本或数据密集表格场景除外) |

---

Expand Down
3 changes: 2 additions & 1 deletion skills/lark-whiteboard/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
name: lark-whiteboard
description: >
当用户要求在飞书云文档中绘制图表,或使用飞书画板绘制架构图、流程图、思维导图、时序图或其他可视化图表时使用此 skill。
当用户需要可视化表达架构、流程、组织关系、时间线、因果、对比等结构化信息时使用此 skill,无论是否提及"画板"。
如果用户主要意图是创建文档(可能含画板),应由 lark-doc 主导并联动本 skill。
compatibility: Requires Node.js 18+
metadata:
requires:
Expand Down
Loading