| name | feishu-whiteboard-pro |
| description | 把内容生成为「真正设计过」的可编辑飞书白板——强视觉层级、有意图的构图、留白，而不是 一堆等大方块。先定设计简报（构图原型 + 配色策略 + 字号角色 + 反套路检查）再画，按坐标 骨架施工，渲染后跑设计评审（层级/平衡/密度/对比/对齐）补到最弱项达标，最后写进你自己的 飞书文档成为可编辑白板。飞书走扣子「平台授权」，一键授权即用（见 CREDENTIALS.md）。
|
| dependency | {"python":["requests==2.31.0"]} |
飞书白板大师
一个面向飞书 SVG 白板的设计判断技能。它不是给你一套配色就让你随手摆——它强制
画之前先写设计简报、渲染后做设计评审。产出是写进你飞书文档里的、真实可编辑的白板。
白板媒介是刻意受限的：单一字体、只有原生矩形/圆/连接线、无渐变、无滤镜、无透明度、无动效。
所以这里的「好看」= 构图、层级、节奏、配色克制、留白，绝不靠特效。功力花在这些上。
三件事决定成败，各有归属：
- 媒介允许什么 →
RULES.md。硬限制，真机验证过。必读。
- 怎么构图 →
COMPOSITION.md。带坐标骨架的原型、字号体系、间距栅格。技能核心。
- 到底好不好 →
CRITIQUE.md。渲染后的设计评分表与逐项修法。
何时使用
- 用户想要一张飞书 / Lark 白板、信息图、流程图、海报、系统图或可视化讲解，且要它看起来
真的被设计过——清晰焦点、真实层级，不是一墙等大方块。
- 用户给了内容（"把 X 讲成白板""把这段变成图"），想要它可视化、可编辑、在飞书画布上。
第 0 步：前置条件（动手前先查）
- 飞书授权（Agent 必读，照做别猜）：技能以用户本人身份写入其飞书租户，走扣子平台授权。用户在扣子一键授权后，
运行时自动注入
COZE_FEISHU_WHITEBOARD_<后缀>（后缀因环境而异，脚本按前缀自动识别，不用关心后缀是 project 还是 skill id）。
技能代码不碰 OAuth、不需要建应用或填密钥（详见 CREDENTIALS.md）。
- 注入只在「技能运行时」发生：主对话 / 裸终端没有这个变量，必须在扣子「调试/预览」里跑本技能。
- 写飞书前先自检：
python3 scripts/feishu_write.py --check。READY 才写；NOT_READY 就把它打印的指引原样转达用户去扣子完成授权。
- 拿不到凭证时绝不改用 lark-cli、绝不自造授权链接——本技能只依赖扣子注入。写入不可用不等于任务失败：照样交付本地 PNG + SVG。
- 沙箱已具备 Python（写入层，标准库即可）、Node（本地渲染）、
npx @larksuite/whiteboard-cli（npx 自动下载）。
管线（两道闸门，都不能跳）
理解内容
│
├─▶ 闸门 1 · 设计简报 （写任何 SVG 之前 —— 见下）
▼
按骨架构图 （COMPOSITION.md：原型坐标 + 字号体系 + 间距栅格）
│
▼
渲染 → 修正确性 （RULES.md：溢出 / 重叠 / 裁切 / 箭头）
│
▼
闸门 2 · 设计评审 （CRITIQUE.md：评分、补最弱项、重渲、循环）
│
▼
写进飞书 → 看实时白板 → 交付
1. 理解内容
弄清白板要承载什么：内容、目的、受众。内容不清就问一个短问题。不要问用户视觉风格——
那是你在简报里自己定，最后再提供换色。
闸门 1 · 设计简报（强制，写 SVG 之前）
先读 COMPOSITION.md 和 CATALOG.md，再写下这五条承诺
（叙事形状→原型、焦点、配色策略+palette、字号角色、反套路检查）。详见 COMPOSITION.md。
配色优先选 CATALOG.md 里的锚点 palette（可靠、可换肤）；若没有合适的，按
templates/GENERATE.md 现场生成一套——它产出同样的 frontmatter 形态，
照样可换肤，本轮内联使用即可（不必写进技能目录）。
用一句话告诉用户你选了哪个原型和 palette、为什么，然后开画。
2. 按骨架构图
匹配的原型若在 examples/ 里有，就从那个 .svg 起步、替换内容。在逻辑坐标
空间（≈1600–1700 宽）写 SVG，遵循 COMPOSITION.md 的骨架/字号/栅格，以及 RULES.md 全部硬规则。
只把内容放上画布——绝不放提示词、来源、风格名或任何 meta 行。
3. 渲染 → 修正确性
先不渲染预测缺陷：node scripts/fit-check.mjs <dir>/diagram.svg（标签过宽/挤占/出血）。
然后按 RULES.md 渲染并真的打开 PNG 看：
npx -y @larksuite/whiteboard-cli@^0.2.11 -i <dir>/diagram.svg -o <dir>/diagram.png -f svg
就地小步改 SVG，一次看到的问题合并一轮改完再重渲。这步只管正确，不管品味。
闸门 2 · 设计评审（强制，正确性干净后）
按 CRITIQUE.md 五轴（层级/平衡/密度/对比/对齐）打分，点名最弱一项，套用
其修法重渲，循环到没有不及格轴。要真正交付的白板，最好让一个独立评审子 agent 只拿渲染图
和评分表、以对抗姿态评。
4. 写进飞书 → 看实时白板 → 交付
授权由扣子平台授权托管，token 在运行时自动注入，技能这步不做任何 OAuth。先自检再写：
python3 scripts/feishu_write.py --check
python3 scripts/feishu_write.py --svg <dir>/diagram.svg --title "标题" --image <dir>/board.png
--check 报 NOT_READY（或写入报缺凭证）时：把脚本打印的指引原样转达用户（去扣子完成飞书授权 / 确认在「调试·预览」运行时里跑），
不要自己尝试任何授权、不要改用 lark-cli、不要自造授权链接。此时仍交付第 3 步本地渲染的 diagram.png + SVG 源文件给用户，
待用户授权后重跑写入——写入不可用 ≠ 任务失败。
它以用户本人身份建文档（内嵌 <whiteboard type="svg">，服务端解析成可编辑节点）→ 返回文档链接 +
白板 token → 导出白板图 board.png。board.png 对版面/填充忠实、但文字颜色不可靠（颜色以实时文档为准），
而且是飞书把任意画板补白成 ~2560×2560 的固定方图预览——仅用于核对实时白板，不作交付图。
交付两样：飞书文档链接 + 第 3 步本地渲染的 diagram.png（贴合构图、无补白），不要交付方图 board.png。
然后告诉用户可随时换 palette，同构图重渲，只改颜色。
文件
来源与许可（源码层署名，非商店营销文案）
MIT，详见随包 LICENSE。配色与媒介规则改编自 beautiful-feishu-whiteboard（© Zara Zhang，MIT）；构图/评审/fit-check/管线层为原创新增。
注：本段是源码层署名（满足 MIT + 扣子来源标注要求）。商店「详细介绍」营销文案不含此致谢。
