这是什么
beautiful-feishu-whiteboard 是一个面向 AI 代理（如 Claude Code）的技能包，提供 35 种精心策划的配色风格，用于在飞书（Feishu/Lark）中创建美观且可编辑的白板。它不是自动布局工具，而是通过为代理提供配色方案和渲染规则，让代理自主设计布局，最终生成真实可编辑的飞书白板，而非截图。
该项目由 zarazhangrui 开发，基于飞书 SVG 白板渲染器的实际经验，总结了原生形状、透明度限制、文本颜色导出等硬性规则，并封装在 RULES.md 中。
适合谁
- 经常使用飞书白板进行演示、教学或头脑风暴的团队
- 希望借助 AI 代理快速生成视觉化内容的创作者
- 对白板美观度有要求，但不想手动调整配色和布局的用户
- 熟悉 Claude Code 或其他支持 SKILL.md 的 AI 代理的用户
能做什么
- 提供 35 种配色风格，从克制到大胆，涵盖多种视觉氛围（如 Avocado Press、Riso Brut、Cobalt Bloom 等）
- 代理根据你的需求选择合适风格，自动生成白板布局
- 生成的白板可直接在飞书文档中编辑，支持后续修改
- 支持切换风格，随时调整白板视觉
- 内置预检脚本，确保环境配置正确
使用前准备
- Node.js 20 或更高版本
- 飞书/Lark 账号：白板会写入你自己的租户
- lark-cli（npm 包
@larksuite/cli），需要安装并认证 - @larksuite/whiteboard-cli：通过 npx 使用，自动下载
安装方法
你可以通过以下方式安装：
方式一：使用 npx 安装（推荐）
# 项目级安装（./.claude/skills 或代理的 skills 目录）
npx skills add zarazhangrui/beautiful-feishu-whiteboard
# 或全局安装（每个项目可用）
npx skills add zarazhangrui/beautiful-feishu-whiteboard -g
方式二：手动克隆
git clone https://github.com/zarazhangrui/beautiful-feishu-whiteboard \
~/.claude/skills/beautiful-feishu-whiteboard
配置飞书工具
npm install -g @larksuite/cli
lark-cli config init # 首次运行：扫描二维码
lark-cli auth login # 授权你的飞书/Lark 账号
安装后，可随时运行 bash scripts/preflight.sh 检查环境。
使用示例
安装后，直接用自然语言告诉你的代理，例如：
“用 Riso Brut 风格制作一个解释我们入职流程的飞书白板。”
“把这个文档变成飞书上的可视化看板，用极简的钴蓝色调。”
“把系统架构画成飞书白板，用活泼的糖果色。”
代理会询问白板的用途和期望的风格，从目录中选择合适的风格，用原生形状构图，渲染并自我修正（溢出、边距、重叠），然后写入飞书文档，最后发送文档链接和图片。你可以随时切换风格。
内置了 35 种风格模板，截图部分给大家先看看
风险与注意事项
- 该技能依赖飞书/Lark 的 API 和 CLI 工具，需要有效的账号和授权。
- 白板渲染受飞书 SVG 渲染器限制：仅支持原生形状，不支持透明度、渐变或模糊，文本颜色导出有已知问题。
- 安装和使用需要一定的命令行基础，适合进阶用户。
- 项目采用 MIT 许可证，可自由使用和修改。