mcpField
F
feishu-whiteboard-pro

feishu-whiteboard-pro

github.com/lcpmarvel设计与 UI6249 次安装8 周前更新
代码仓库

关于 feishu-whiteboard-pro

用于创建、修改和审查 Feishu SVG 白板的技能，面向需要可编辑图表的设计与项目工作流。它强调内容可核验、原生图形构成，并通过检查脚本和本地渲染验证结果。

主要功能

  1. 01创建及编辑 Feishu SVG 白板
  2. 02按请求选择创建、修改或审查流程
  3. 03使用原生矩形、圆形和连接线
  4. 04运行几何检查并渲染预览
  5. 05按需发布至 Feishu

适用场景

  1. 01把简报内容制作成白板
  2. 02修复或重构现有白板
  3. 03审查图表中的内容与布局
  4. 04发布白板并交付本地 SVG 和 PNG

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lcpmarvel/feishu-whiteboard-pro --skill feishu-whiteboard-pro

安装后在 Claude Code 中输入/feishu-whiteboard-pro确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CATALOG.md
.gitignore
LICENSE
README.md
RULES.md
COMPOSITION.md
CRITIQUE.md
agents/
whiteboard-finish-reviewer.md
coze/
CREDENTIALS.md
build.sh
coze/scripts/
probe_board_api.py
feishu_write.py
examples/
README.md
references/
revise.md
create.md
critique.md
scripts/
build-catalog.mjs
check-repo.mjs
fit-check.mjs
preflight.sh
templates/
GENERATE.md
templates/coral/
design.md
templates/grove/
design.md
templates/mint-brut/
design.md
templates/monochrome/
design.md
templates/polar-signal/
design.md
templates/riptide-cobalt/
design.md
templates/riso-brut/
design.md
templates/signal-night/
design.md
tests/
fit-check.test.mjs

详细介绍

Feishu Whiteboard Pro

创建真实、可编辑的 Feishu SVG 白板，构图经过深思熟虑，内容可验证。 媒介范围刻意保持精简：一种字体、原生矩形／圆形／连接线，不使用渐变、 滤镜、透明度或动态效果。质量取决于内容真实性、层级、拓扑、节奏、对比与留白。

核心约定

  • 以需求为准。 遵循提供的品牌、配色、参考、密度和风格要求。默认设置或反模式警告不能擅自改变明确的请求。
  • 修订应保留；重新设计则替换。 修复时保留内容、关系、几何结构和视觉标识，除非用户指定要更改的方面。重新设计改变视觉系统，而非信息架构。
  • 视觉依据具有权威性。 即使没有单独的设计文档，现有白板、SVG、截图或明确的需求说明仍具有权威性。
  • 关系就是主张。 绝不能为了让布局显得完整而编造箭头、数字、引文、类别、负责人、状态或因果关系。明确标注编写的演示内容。
  • 机械检查与设计判断分开处理。 脚本负责可衡量的缺陷；审阅者负责内容真实性、阅读路径、层级、平衡、密度、实际场景下的对比度和对齐。
  • 验证范围有限。 检查一次，批量修复，确认一次。修复剩余的确定性问题，但不要陷入无休止的审美调整。

设置

将 <skill-dir> 解析为包含此 SKILL.md 的目录；将工作目录保持在用户的项目中。所有捆绑的参考资料和脚本均从 <skill-dir> 解析。

在本地渲染前，运行一次 bash <skill-dir>/scripts/preflight.sh。需要 Node 20+。白板 CLI 通过 npx 运行，首次使用时可能需要网络访问。

只有发布时才需要 Feishu 身份验证。写入线上白板前，运行 bash <skill-dir>/scripts/preflight.sh --publish。如果无法发布，请继续使用本地 SVG 和高清 PNG；不要丢弃有效的本地交付成果。

判断请求类型

每次创建或编辑前都要阅读 RULES.md，然后仅加载一个工作流：

请求工作流默认依据
新建白板或替换构图references/create.md用户内容、参考资料和新白板约定
修复、重组、重新设计样式或简化现有白板references/revise.md现有成品，以及明确指定要更改的方面
审阅、诊断或批准白板references/critique.md当前依据；除非用户要求修复，否则仅供只读

只有在所选工作流需要时，才加载辅助参考资料：

  • 新建结构或重组时，加载 COMPOSITION.md；
  • 选择配色或重新设计样式时，加载 CATALOG.md 和一个 templates/<slug>/design.md；
  • 进行设计审阅和最终交付时，加载 CRITIQUE.md；
  • 仅当没有合适的精选配色满足需求时，才加载 templates/GENERATE.md。

如果无法确定请求是新建还是修订，请先检查提供的成品。只有在选错依据会实质性改变结果时，才提出问题。

构建与验证

对于 SVG 工作：

  1. 如果 examples/*.svg 中有拓扑结构合适的文件，请以其为起点。替换内容后，重新检查旧箭头和元信息文本，不要盲目信任示例。

  2. 运行确定性检查：

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

  3. 渲染并检查紧凑的局部图像：

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

  4. 批量修复可见问题，重新运行适配检查，并进行一次确认渲染。向其他进程传递证据时，请使用 node <skill-dir>/scripts/fit-check.mjs --json <dir>/diagram.svg。

  5. 对于重要交付，请使用新鲜的只读审阅器 agents/whiteboard-finish-reviewer.md。提供原始请求、事实/设计约定、SVG、局部 PNG、检查器输出，以及任何真实的 Feishu 证据。

发布与交付

按照 RULES.md 中的说明，使用准确的 Feishu 创建、更新和查询命令。发布会更改外部状态，因此只有在用户要求创建在线白板或提供了待更新的目标时才进行发布。

发布成功后，交付 Feishu 文档链接，以及本地的 diagram.svg 和紧凑版 diagram.png。正方形 Feishu 导出图是验证证据，不是分享图片。如果无法发布，请交付本地文件，并明确说明仍需完成的身份验证步骤。

仓库文件

  • RULES.md — 已验证的媒介约束和发布命令。
  • references/ — 创建、修改和评审指南；每次请求加载一份。
  • COMPOSITION.md — 间距、字号比例、图表类型和避免条件反射的指导。
  • CRITIQUE.md — 真实性关卡、五个视觉维度和有界评审流程。
  • CATALOG.md — 生成的调色板索引。
  • templates/ — 精选调色板和可选的生成方案。
  • examples/ — 可编辑的高标准 SVG 起始文件及其渲染图。
  • scripts/fit-check.mjs — 确定性媒介与未变换几何检查器，可输出文本和 JSON。
  • scripts/check-repo.mjs — 离线仓库回归检查。
  • scripts/preflight.sh — 本地与发布就绪检查。

评论

支持 Markdown