SuperAPI AI 工具集

figma-comments

设计与创作

查看项目

更新于 10-16 00:20

技能介绍

用途:该技能用于管理 Figma 文件评论。评论只存在于 Figma REST API 中,插件 API(use_figma)和原生 Figma MCP 都无法访问,因此需要该技能来读取评论线程、发布新评论(可固定到节点)、回复已有线程以及删除评论。

主要能力:get-comments.sh 列出评论线程,含作者、内容、时间戳、固定节点和解决状态,默认过滤已解决线程,支持 --include-resolved 和 --md;post-comment.sh 可发布文件级评论、节点固定评论或线程回复;delete-comment.sh 按 id 删除评论。

使用方式:需终端和令牌。适用于 Claude Code、Cursor、Codex 或 Gemini CLI,不能在纯 Claude Desktop 或 claude.ai 聊天中运行。必须自备 Figma 个人访问令牌(Settings → Security → Personal access tokens,需 File content: read 及 Comments: read/write),通过 export FIGMA_TOKEN="figd_…" 设置,脚本从环境变量读取,切勿将令牌写入技能文件。所有请求使用 X-Figma-Token 请求头访问 https://api.figma.com。文件 key 可用 FILE_KEY=$(echo "$FILE_URL" | sed -E 's#./(design|file)/([A-Za-z0-9]+).#\2#') 获取。

限制:@提及仅为 Figma UI 功能,在消息中写 @name 只会显示为纯文本,不会触发通知。发布/删除返回 403 说明令牌缺少 Comments: Read and write 权限。删除父评论会移除整个线程,若要部分删除需先删回复。pin 时 client_meta 需含 node_id 和 node_offset,脚本默认 (0,0)。