飞书白板大师
产出写进飞书文档、可继续编辑的 SVG 白板。媒介刻意受限：单一字体、原生矩形/圆/连接线，
无渐变、滤镜、透明度和动效。质量来自事实、构图、层级、节奏、对比和留白。
共通契约
- 用户简报优先。 明确的品牌、配色、参考、密度和风格要求胜过默认偏好。
- 修改要保留，重设计才替换。 修复不改事实、关系、拓扑和视觉身份；换肤不重排信息。
- 每条线都是事实。 不为版面完整而发明箭头、数字、引语、分类、负责人、状态或因果关系；
自拟演示内容必须明确标为示例。
- 机械检查与审美判断分开。 脚本负责可测缺陷，评审负责事实忠实度、阅读路径和五轴设计。
- 检查有上限。 看一次、批量修、确认一次；之后只清剩余确定性错误，不无限抛光。
先路由，再加载
每次构建或修改都读 RULES.md，然后只加载一条工作流：
| 请求 | 工作流 |
|---|
| 新白板或替换整套构图 | references/create.md |
| 修复、重构、换肤、简化已有白板 | references/revise.md |
| 评审、诊断、决定是否可交付 | references/critique.md |
按需再读：重构读 COMPOSITION.md；选色只读 CATALOG.md 和选中的一个模板；评审读
CRITIQUE.md；只有锚点都不合适才读 templates/GENERATE.md。
授权与运行环境
扣子以用户本人身份写入飞书，运行时自动注入 COZE_FEISHU_WHITEBOARD_<后缀>；代码不碰
OAuth，不需要自建应用或填写密钥。凭证只存在于扣子「调试/预览」的技能运行时。
写飞书前运行：
python3 scripts/feishu_write.py --check
READY 才发布。NOT_READY 时把脚本指引原样转达用户；不要改用 lark-cli，不要自造授权
链接。授权不可用不阻塞本地设计、检查和 SVG + PNG 交付。详见 CREDENTIALS.md。
构建与检查
-
按所选 workflow 写内容/事实契约和设计简报。开放或高风险任务才给三个廉价黑白
wireframe；明确小任务直接做。
-
有匹配拓扑时从 examples/*.svg 起步，但重新检查旧箭头和 meta 文案。
-
运行确定性检查：
node scripts/fit-check.mjs <dir>/diagram.svg
-
渲染并真正查看紧边本地图：
npx -y @larksuite/whiteboard-cli@^0.2.11 \
-i <dir>/diagram.svg -o <dir>/diagram.png -f svg
-
批量修一轮并确认一轮。重要交付在平台支持子 agent 时使用
agents/whiteboard-finish-reviewer.md；否则按同一输入/输出契约做一次结构化自评。
发布与交付
用户要求写入飞书且 --check 为 READY 时运行：
python3 scripts/feishu_write.py --svg <dir>/diagram.svg --title "标题" --image <dir>/board.png
返回文档链接和白板 token。board.png 是飞书补白后的方形核对图，只用于验证实板；文字颜色
以实时文档为准。
最终交付飞书文档链接（发布成功时）+ diagram.svg + 紧边 diagram.png。授权不可用时交付
后两者，并说明只差哪一步授权。
文件
RULES.md：媒介硬规则与真值约束。references/：创建、修改、评审工作流，每次只读一条。COMPOSITION.md：构图原型、字号、间距、反套路。CRITIQUE.md：事实门、五轴设计和终审流程。CATALOG.md、templates/：精选 palette 与可选生成规则。agents/whiteboard-finish-reviewer.md：只读终审契约。scripts/fit-check.mjs：确定性检查及 JSON 输出。scripts/feishu_write.py：用户身份写入飞书并导出核对图。CREDENTIALS.md：扣子平台授权说明。
来源与许可
MIT，详见 LICENSE。配色与媒介规则改编自 beautiful-feishu-whiteboard（© Zara Zhang，MIT）；
构图、评审、检查和管线层为原创新增，设计判断机制受 impeccable / frontend-design 启发。