用途:该技能面向飞书场景的可视化与展示,按目标飞书产物选择对应载体工作流。加载工作流后,references/、scripts/、templates/、examples/ 等相对路径按 workflow.md 所在目录解析,执行脚本使用解析后的实际路径,不依赖当前 shell 目录。
主要能力与路由:未指定载体的数据图表选择读取 dataviz 工作流;静态画板(SVG/Mermaid/PlantUML 导入、手写节点、取回源码、克隆、质检、导出)读取 board 工作流;Slides 幻灯片/PPT(创建、读 XML、按页增删改、截图预览、上传图片)读取 slides 工作流;文档内动态交互、CSS/JS、ECharts、3D、window.magic 小程序读取 htmlbox 工作流;妙搭 HTML 应用(创建、发布、查发布状态、访问范围)读取 apps 工作流。载体边界:文档内动态或交互用 htmlbox,静态可编辑画板用 board,演示文稿用 slides,发布妙搭 HTML 应用用 apps,消息通知卡片属于 feishu-cli-messaging 的 card 工作流。
使用方式与限制:身份方面,board、doc htmlbox、slides 的写命令默认 Bot,操作用户已有文档、画板或演示文稿时显式传 --user-access-token(或 FEISHU_USER_ACCESS_TOKEN);Slides 新建优先用 User,应用未开通 tenant 的 slides:presentation:create 时 Bot 创建报 99991672(exit 3);apps 全部命令必须 User Token + spark scope。破坏性操作先问用户:board delete、slides delete-slide、妙搭应用设为 --scope public 前需确认;board import/update/create-notes --overwrite 会清空整张画板,board update --overwrite 先加 --snapshot old.json 留备份;删除类命令以退出码 10 返回时是在等确认,不要自行补 --yes。不重复写入:board update/svg-import/create-notes/import --engine local 结果不明时用同一 --client-token 重跑,服务端 board import 不接受 client token。妙搭发布需用户明确同意,先 apps html-publish --dry-run 确认 would_block=false,--wait 或 apps release get 看到 finished 才算完成,online_url 默认仅创建者可见。落地后自检:画板用 board image 看缩略图(写入后可能滞后 10–20 秒),Slides 用 slides screenshot,HTMLBox 落库前跑 verify.sh;改动色板或底色后运行 dataviz 校验脚本。主题和风格为默认选项,优先满足用户指定的品牌色、明暗主题和载体并验证可读性。身份或 scope 报错读取 ../feishu-cli-platform/references/workflows/auth/references/identity.md,判断成败或处理确认门禁读取 agent-contract.md。