2.7 KiB
2.7 KiB
lark-doc 画板处理指南
前置条件： 先阅读
../../lark-shared/SKILL.md了解认证、全局参数和安全规则。
两个 Skill 的职责边界
| Skill | 核心职责 | 约束 |
|---|---|---|
lark-doc |
文档内容读取/更新、插入空白画板占位、获取 board_token | 不能直接编辑画板内容；docs +update 的画板能力仅限插入空白占位 |
lark-whiteboard |
查询/导出画板（+query）；图表内容生成（Mermaid/DSL/SVG 路由、场景选型、渲染验证）；写入画板（+update） | 图表内容生成由此 skill 完整执行，不依赖外部调度 |
文档与画板协同流程
步骤 1：判断场景
| 场景 | 入口 |
|---|---|
| 文档中需要插入新画板 | 继续步骤 2 |
| 已有画板需要更新内容 | 先 docs +fetch 获取 board_token，跳至步骤 3 |
| 只查看 / 下载已有画板 | 切换至 lark-whiteboard，不走本流程 |
步骤 2：在文档中创建空白画板
- 创建场景：
docs +create；编辑场景：docs +update - markdown 中使用
<whiteboard type="blank"></whiteboard>（不要转义） - 多个画板时，在相应的地方插入各自的 whiteboard 标签
- 从响应的
data.board_tokens中读取 token 列表
步骤 3：生成并写入画板内容
读取 ../../lark-whiteboard/SKILL.md，跳至"渲染 & 写入画板"章节，按其完整流程为每个 board_token 生成并写入图表内容。
多个画板时依次处理，每个画板完成后再处理下一个。
步骤 4：完成校验
- 确认每个 token 对应的画板都已填充真实内容
- 不保留空白占位画板；只有空白画板而无内容视为任务未完成
语义与画板类型映射
| 语义 | 画板类型 |
|---|---|
| 架构/分层/技术方案/模块依赖/调用关系 | 架构图 |
| 流程/审批/部署/业务流转/状态机 | 流程图 |
| 跨角色流程/跨系统交互/端到端链路 | 泳道图 |
| 组织/层级/汇报关系 | 组织架构图 |
| 时间线/里程碑/版本规划 | 里程碑图 |
| 因果/复盘/根因分析 | 鱼骨图 |
| 方案对比/技术选型/功能矩阵 | 对比图 |
| 循环/飞轮/闭环/增长链路 | 飞轮图 |
| 层级占比/能力模型/需求层次 | 金字塔图 |
| 矩形树图/层级面积占比 | 树状图 |
| 转化漏斗/销售漏斗 | 漏斗图 |
| 分类梳理/知识体系/思维导图/时序图/类图 | Mermaid |
| 数据分布/占比/饼图 | Mermaid |
| 柱状图/条形图/数据对比 | 柱状图 |
| 折线图/趋势图/时序数据 | 折线图 |
关联参考
- 画板查询/创作/修改/渲染写入：
../../lark-whiteboard/SKILL.md