SuperAPI AI 工具集

seed-migrate-component-docs-from-figma

设计与创作

查看项目

更新于 10-15 20:30

技能介绍

用途:根据 Figma 文档图层的内容与图片,撰写或更新 SEED Design 组件指南 MDX。

输入与范围:需要 Figma 节点 URL,缺失且无法从其他工具或上下文获取时向用户索取。文件名可由用户给出的名称、目标 MDX 路径或既有组件 ID 推断,仍不明确时才询问。目标文件为 docs/content/components/{file-name}.mdx。若只是局部修改现有文件,只读取目标章节和必要的 Figma 节点,不重新提取整篇文档。

主要步骤:一、用 get_node_info 提取各节点 URL 内容,仅在多个 URL 相互独立且适合合并结果时并行,否则顺序提取,结构化 heading、正文、表格、Do/Don't 与图片位置。二、撰写 MDX,新文档或新章节只读 references/patterns.md 中的 MDX 组件规则,局部修改沿用相邻现有模式;只使用 Figma 中的正文内容,不添加或改变含义;粗体转为 bold,表格转为 Markdown table;提及真实组件时链接到对应页面;FigmaImage 放在正文之后;仅当 Figma 存在相应章节时按 Anatomy → Properties → Guidelines → Comparison → V3 Changes → Specification 顺序组织;使用韩语敬语,组件名与技术术语保留官方英文写法;图片 ID 留空占位。三、映射图片 ID,在父图层用 find_nodes(name: "Document / Image", nodeId: "{parent layer ID}") 查找,仅当文档流与父子关系能明确顺序时按序填入 id=""、figmaId="";若数量不一致或存在多种合理对应而无法确定,不随意分配,继续调查可确认的父级与顺序,仍未解决再询问用户。四、复查目标范围,仅在改动处检查 PlatformStatusTable(组件指南应紧跟 frontmatter)、ComponentSpecBlock(仅在实际相关 Rootage spec 时置于 Specification 下)、Markdown 语法、官方英文组件名、语句与组件混淆、重复内容,并核对新增或变更的组件链接与 token 链接;若 Figma 涉及 Web/React、iOS、Android 等平台内容,向用户说明发现的事实与文档覆盖范围。

限制:不得虚构 Figma 之外的内容;映射不明确时不得擅自分配。参考资料为 docs/content/components/radio.mdx 与 action-button.mdx,仅在需要对应模式时参考。