用途:从 Figma 线框 URL 逐步抽取规格文档,以 Markdown 输出到 docs/ 下,供后续开发参照。
输出结构:docs/ 下含 pages/(README 索引与各页文档,每页固定 6 个章节:构成要素/文本要素一览/操作按钮/参照模型/使用组件/相关未解决问题)、use-cases.md、actors.md、data-model.md、components.md、reviews/(coverage-review.md、data-model-review.md、components-review.md);extension 模式另有 existing-codebase.md。
主要能力:15 步流程逐步生成,页面结构/操作抽取等步骤可按页面并行;ID 采用带作用域命名(UC-XX、A-XX、E-XX、E-XX.C-YY、CMP-XX 等),按发现顺序两位补零编号,引用时须并记名称。
使用方式:需已认证的 figma-dev MCP 服务器(未认证时用 /mcp 提示认证);用户需提供 Figma URL(https://www.figma.com/design/:fileKey/...)、项目目标、转写目标(本地 Markdown/Notion/GitHub Wiki 等)与实现模式。实现模式分 new 与 extension,运行模式分全自动、混合(推荐)、反覆反映(extension 推荐)。
原则与限制:Figma 中未明示的属性不做推测补全,不擅自添加登录、认证、支付等功能,不编造人物画像属性;仅允许从构成要素客观导出的内容。评审步骤(Step 6/9/12)才列举缺失项。数据模型定义避免过度(如 StaticPage、User、Session 等通用实体仅在评审中建议)。
适用场景:新应用的线框规格化,或既有仓库的功能扩展(extension 模式先调查既有模型、路由、视图资产,按既有模型复用→加列→新实体的顺序设计)。