Agent Skills
返回列表
📁

飞书画板便签墙

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md 的官方指南，将 @user_0995d4a8/lark-whiteboard-sticky-johnliu 这个技能安装到我的 AI 助手中。

技能介绍

解决什么问题

飞书白板的便签很适合做用户故事墙、评审意见汇总和头脑风暴，但手写效率极低：一张 50 条便签的墙，手动创建和摆放可能要半小时以上。而直接调用 OpenAPI 又有一整套细节问题——sticky_note 节点必须带当前用户的 user_id，否则报 2890002；画板内容更新是追加式的，重画整块画板时新旧便签会叠在一起；便签字号由画板自动缩放，自己很难预测最终效果。

这个技能把「从一份结构化清单到一张可读的便签墙」压缩成一条命令的流程。

核心能力

  • DSL 驱动：用 diagram.json 描述每个便签的内容、坐标、颜色，不与画板 API 耦合
  • 字号自适应规则：自动缩放的触发条件与规避方式已整理成参考文档，配合窄列宽 216、纵向叠放的网格范式，避免出现个别便签字号异常大的情况
  • 9 色配色与网格布局：统一视觉规范，多便签场景直接套用
  • 上传脚本自动化：转换 OpenAPI 请求、注入 sticky_note.user_id、调用 lark-cli +update 一步完成
  • 本地预览：whiteboard-cli 渲染 diagram.png，先检查布局再上传

工作流程

  1. 取 board_token：从已有文档的文档块提取，或新建文档时内嵌画板，从返回的 new_blocks 中拿到 block_type == "whiteboard" 的 token
  2. 写 DSL：便签较多时建议写 .cjs 脚本生成 JSON，比手写更容易调整
  3. 本地预览（可选）：npx -y @larksuite/whiteboard-cli -i diagram.json -o diagram.png
  4. 上传：脚本自动完成全部转换与注入；全新画板省略 --overwrite，整体重画必须带上
  5. 验证：导出真实画板图片（lark-cli whiteboard +query ... --output_as image），检查内容截断、便签重叠、行列对齐和字号一致性

适用边界与注意点

  • 依赖 lark-cli 已登录 user 身份，且 scope 含 board:whiteboard:node:create，认证问题不在本技能范围内
  • 画板 DSL 的通用语法、配色和布局规则沿用 lark-whiteboard skill 的 elements/ 文档，本技能只覆盖便签特有部分
  • 预览图的字号与真实画板可能不一致（预览引擎也在模拟 auto font），字号以画板导出图为准
  • 手动上传不可取：必须逐个把 sticky_note.user_id 设为当前用户的 open_id，漏填就是 2890002
  • 画板更新是追加语义，不传 --overwrite 重画整墙只会得到新旧重叠的混乱结果

使用场景

  • 敏捷团队要把一轮迭代的用户故事卡片贴到飞书白板做评审，手动逐条新建 50 张便签太慢，想用脚本一次性生成整墙。
  • 设计评审会上要汇总 30 多位同事的反馈便签，希望按行列整齐排列、统一配色，而不是大家各自贴在任意位置。
  • 头脑风暴收集到几十条想法，需要按类别分列展示在白板上，手动摆放经常重叠，想用脚本一次成型。
  • 对已有白板做二次更新时，需要在原有便签旁边补充新内容且不覆盖旧便签，靠追加上传和 --overwrite 控制。

适合人员

  • 敏捷教练，每轮迭代都要在白板上搭建用户故事墙，诉求是用脚本批量生成而非逐张拖拽。
  • 产品经理，负责组织评审会并把多位同事的意见汇总成整齐的便签墙，诉求是统一布局、配色和字号。
  • 工具链开发者，需要调用飞书白板 OpenAPI 生成便签，关心 user_id 注入和追加更新的细节。
  • 工作坊组织者，经常在线下活动后把收集到的便签内容数字化上墙，诉求是快速把文本清单变成可视化墙面。