用途:在缺少完整規格的情境下(如只有 Figma 設計稿、API 尚未就緒),由 AI PM/系統分析師 Agent 從 Figma 畫面反向推導前端開發的基礎規格,產出高品質 draft-spec.md,供工程師審閱後交接給下游 Agent。API 對應由後續 api-enrichment 處理。
主要能力:解析 Figma 頁面與 Frame 清單、頁面結構順序、主要 UI 元件(Node ID、名稱、類型)、文案與 Label、互動線索(Hover、按鈕連接 Frame、Loading/Empty/Error 狀態)、視覺層級與骨架節點;建立 Node Coverage Ledger;標記 UI 所需待補充數據模型;規劃元件拆分(Base/Feature/Container);產生含功能範圍、元件拆分、互動行為、欄位型別、待定數據模型、開放問題與假設等章節的 draft-spec.md。
使用方式:先確認輸入材料,Figma 連結為唯一必填,缺少時輸出 blocked payload 並停止;User Story 為可選。以 mcp-figma 解析畫面,僅記錄 Figma 中明確可見資訊。若有 User Story 可作為理解輔助,但不涉及 API 解析。輸出 draft-spec.md 後進入斷點 A,等待工程師回覆「Approve」;收到後輸出交接 payload,含 spec_path、approved_node_ids、covered_node_ids、uncovered_node_ids 等欄位。
適用場景:PM 沒給規格、只有 Figma 設計稿、API 還沒好先做規格、補規格文件、draft-spec、開發規格草稿等。
限制:僅基於 Figma,不引入 OpenAPI 解析;不推導 endpoint、status code、error message;推測須標記 [Assumption],待決策項標記 [Open Question];Node ID 須直接複製 mcp-figma 回傳值;未收到 Approve 前不繼續下游產出。實際安裝與執行方式暫未提供。