Coze

---
name: feishu-whiteboard-pro
version: 1.1.0
description: >
  创建、修改、换肤和评审真正经过设计的可编辑飞书白板。适用于信息图、流程图、系统图、
  时间线、决策板、海报和可视化讲解：先锁定内容事实与设计简报，再按白板媒介构图，机械检查
  SVG，查看真实渲染，并在重要交付前做独立终审；避免等大卡片网格和凭空补造关系。飞书写入
  使用扣子平台授权，授权暂不可用时仍交付本地 SVG + PNG。
dependency:
  python:
    - requests==2.31.0
---

# 飞书白板大师

产出写进飞书文档、可继续编辑的 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，不需要自建应用或填写密钥。凭证只存在于扣子「调试/预览」的技能运行时。

写飞书前运行：

```bash
python3 scripts/feishu_write.py --check
```

`READY` 才发布。`NOT_READY` 时把脚本指引原样转达用户；不要改用 lark-cli，不要自造授权
链接。授权不可用不阻塞本地设计、检查和 SVG + PNG 交付。详见 `CREDENTIALS.md`。

## 构建与检查

1. 按所选 workflow 写内容/事实契约和设计简报。开放或高风险任务才给三个廉价黑白
   wireframe；明确小任务直接做。
2. 有匹配拓扑时从 `examples/*.svg` 起步，但重新检查旧箭头和 meta 文案。
3. 运行确定性检查：

   ```bash
   node scripts/fit-check.mjs <dir>/diagram.svg
   ```

4. 渲染并真正查看紧边本地图：

   ```bash
   npx -y @larksuite/whiteboard-cli@^0.2.11 \
     -i <dir>/diagram.svg -o <dir>/diagram.png -f svg
   ```

5. 批量修一轮并确认一轮。重要交付在平台支持子 agent 时使用
   `agents/whiteboard-finish-reviewer.md`；否则按同一输入/输出契约做一次结构化自评。

## 发布与交付

用户要求写入飞书且 `--check` 为 `READY` 时运行：

```bash
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 启发。