用途：在 Figma 文件的两个版本之间生成发布说明风格的 Markdown 变更日志，基于与 figma-version-history 相同的版本差异，并补充作者句柄、标签和时间戳。
主要能力：输出包含 From/To 版本引用（标签或未标注、日期、作者句柄）及天数跨度的头部；页面结构部分列出新增、删除、重命名的页面；传入 --components 时输出组件部分，含每个组件的变更计数，以及重命名、描述变更、子项增删、componentPropertyDefinitions 变更和变量绑定变更的条目；Notes 部分列出差异的已知盲区（画布上的实例、原始布局/视觉属性、变量值变更、样式内容，这些 Figma REST 对历史版本均不暴露）。
使用方式：需要终端和令牌。该技能运行 shell 命令，适用于 Claude Code（含 Claude Desktop 的 Code 标签页）、Cursor、Codex 或 Gemini CLI，不能在纯 Claude Desktop 或 claude.ai 聊天中运行。Figma 连接器的 OAuth 登录不授权这些 REST 调用，需自备 Figma 个人访问令牌：在 Figma 中进入 Settings → Security → Personal access tokens，生成具有 File content: read（以及 File versions: read）范围的令牌，然后在 shell 中设置：export FIGMA_TOKEN="figd_…"。脚本在运行时从环境读取，切勿将令牌写入技能文件。所有请求使用 X-Figma-Token: $FIGMA_TOKEN 访问 https://api.figma.com。
文件键提取：FILE_KEY=$(echo "$FILE_URL" | sed -E 's#./(design|file)/([A-Za-z0-9]+).#\2#')
工作流：先列出两个版本（如无 ID）：../figma-version-history/scripts/list-versions.sh ABC123def456。生成变更日志：node scripts/generate-changelog.mjs --file ABC123def456 --from 4096761871 --to current；包含组件变更：node scripts/generate-changelog.mjs --file ABC123def456 --from 4096761871 --to 4096800000 --components 695:313,420:88 --mode detailed。默认将 Markdown 打印到 stdout，传 --json 得到 { markdown, data }，可重定向到文件：node scripts/generate-changelog.mjs --file ABC123def456 --from 4096761871 --to current > CHANGELOG-figma.md。模式与差异一致：summary（一行计数）、standard（分节带计数，默认）、detailed（完整逐属性和逐绑定条目）。
限制：作者补充为尽力而为，最多回溯约 200 条版本列表条目查找元数据；若版本更旧或由 Figma 系统归属，引用会优雅降级为版本 id。current/HEAD 引用渲染为“Current state (last modified …)”。